Skip to content

Commit 173c4fe

Browse files
ericyangpanclaude
andcommitted
feat(i18n): add content directories for 8 new languages
Created articles, docs, FAQ, and manifesto directories for es, fr, id, ja, pt, ru, tr, and zh-Hant locales. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 2953832 commit 173c4fe

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

48 files changed

+2816
-0
lines changed
Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: 'Getting Started with AI Coding: A Comprehensive Guide'
3+
description: 'Learn how to set up your first AI-powered development environment with IDEs, CLIs, and the essential tools you need to boost your coding productivity.'
4+
date: '2025-01-15'
5+
---
6+
7+
The rise of AI-powered coding tools has fundamentally transformed how developers write, debug, and maintain code. Whether you're a seasoned engineer or just starting your coding journey, integrating AI into your development workflow can dramatically boost your productivity and code quality.
8+
9+
## Why AI Coding Matters
10+
11+
Traditional coding involves writing every line manually, looking up documentation, and debugging through trial and error. AI coding assistants change this paradigm by:
12+
13+
- Providing intelligent autocomplete that understands context
14+
- Generating boilerplate code from natural language descriptions
15+
- Catching bugs before they make it to production
16+
- Explaining complex code in plain English
17+
- Suggesting optimizations and best practices
18+
19+
## Choosing Your IDE
20+
21+
Your choice of IDE is crucial for AI coding. The two most popular options are:
22+
23+
### Cursor
24+
25+
Built from the ground up for AI pair programming. Cursor offers native AI chat, inline editing, and codebase-wide understanding. Best for developers who want AI deeply integrated into every aspect of their workflow.
26+
27+
### VS Code + Extensions
28+
29+
Combine the familiar VS Code interface with AI extensions like GitHub Copilot, Codeium, or Tabnine. Best for developers who want to keep their existing setup while adding AI capabilities.
30+
31+
## Setting Up Your First AI Coding Environment
32+
33+
Here's a step-by-step guide to get started:
34+
35+
### 1. Choose Your IDE
36+
37+
Download and install either Cursor or VS Code with your preferred AI extension.
38+
39+
### 2. Configure API Keys
40+
41+
Most AI coding tools require API keys from providers like OpenAI, Anthropic, or DeepSeek. Sign up for an account and generate your keys.
42+
43+
### 3. Practice with Simple Tasks
44+
45+
Start by asking your AI agent to generate simple functions, explain code snippets, or suggest improvements to existing code.
46+
47+
## Next Steps
48+
49+
Once you're comfortable with basic AI coding, explore advanced topics like prompt engineering for better code generation and integrating AI into your CI/CD pipeline.
50+
51+
The AI coding ecosystem is evolving rapidly. Stay updated with the latest tools and best practices through the [AI Coding Stack](/ai-coding-stack) documentation.
Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
---
2+
title: 'Understanding MCP Servers: The Future of AI Context'
3+
description: 'Deep dive into Model Context Protocol servers, how they work, and why they are crucial for building intelligent AI coding assistants that truly understand your project.'
4+
date: '2025-01-10'
5+
---
6+
7+
Model Context Protocol (MCP) servers represent a paradigm shift in how AI agents interact with external tools, data sources, and APIs. They are the connective tissue that transforms isolated AI models into context-aware coding companions that truly understand your project.
8+
9+
## What is MCP?
10+
11+
The Model Context Protocol is an open standard developed by Anthropic that enables AI agents to securely connect to external data sources and tools. Think of MCP servers as specialized adapters that give your AI agent superpowers—whether that's reading from databases, searching the web, interacting with APIs, or accessing your filesystem.
12+
13+
Unlike traditional API integrations that require custom code for each tool, MCP provides a standardized interface. This means any MCP-compatible AI agent can use any MCP server without custom integration work.
14+
15+
## How MCP Servers Work
16+
17+
An MCP server is a lightweight process that exposes three core primitives:
18+
19+
### Resources
20+
21+
Context and data that the AI can read. For example, a filesystem MCP server exposes your project files as resources.
22+
23+
### Tools
24+
25+
Actions the AI can perform. A web search MCP might expose a search tool, while a database MCP could provide query execution tools.
26+
27+
### Prompts
28+
29+
Templated interactions that guide the AI. These can include best practices or common workflows specific to the tool.
30+
31+
## Popular MCP Servers
32+
33+
The MCP ecosystem is rapidly growing. Here are some essential servers:
34+
35+
- **Filesystem** - Access local files and directories
36+
- **Playwright** - Browser automation and web scraping
37+
- **Context7** - Up-to-date library documentation
38+
- **PostgreSQL** - Database queries and schema inspection
39+
- **GitHub** - Repository management and code search
40+
- **Brave Search** - Real-time web search capabilities
41+
42+
## Why MCP Matters for AI Coding
43+
44+
Before MCP, AI coding assistants were essentially blind to your development environment. They could generate code based on training data, but couldn't access your actual project structure, read your configuration files, or interact with your development tools.
45+
46+
MCP changes this fundamentally. With MCP servers, your AI agent can:
47+
48+
- Understand your entire codebase structure through filesystem access
49+
- Look up current documentation for libraries you're using
50+
- Execute database queries to understand your data model
51+
- Search the web for the latest solutions to your specific problem
52+
- Interact with your Git repository to understand commit history
53+
54+
## Getting Started with MCP
55+
56+
Most modern AI coding tools now support MCP. Setting up your first MCP server typically involves:
57+
58+
### 1. Choose an MCP Server
59+
60+
Start with something simple like the filesystem or web search MCP server.
61+
62+
### 2. Install the Server
63+
64+
Most MCP servers are distributed as npm packages or Python modules. Follow the installation instructions for your chosen server.
65+
66+
### 3. Configure Your IDE
67+
68+
Add the MCP server configuration to your IDE's settings. The exact format varies by tool, but typically involves specifying the server's command and any required arguments.
69+
70+
Here's an example configuration for Claude Code:
71+
72+
```json
73+
{
74+
"mcpServers": {
75+
"filesystem": {
76+
"command": "npx",
77+
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/your/project"]
78+
},
79+
"brave-search": {
80+
"command": "npx",
81+
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
82+
"env": {
83+
"BRAVE_API_KEY": "your-api-key-here"
84+
}
85+
}
86+
}
87+
}
88+
```
89+
90+
### 4. Test the Integration
91+
92+
Ask your AI agent to use the newly connected tools. For example, if you installed a filesystem MCP, try asking it to read a specific file from your project.
93+
94+
## The Future of MCP
95+
96+
The MCP ecosystem is still in its early stages, but the potential is enormous. As more developers build MCP servers for specialized tools and services, AI agents will become increasingly powerful and context-aware.
97+
98+
We're moving toward a future where your AI coding assistant has seamless access to every tool in your development workflow—from your IDE to your cloud infrastructure. MCP is the protocol that makes this vision possible.
99+
100+
Explore the full catalog of available MCP servers in our [MCP Servers directory](/ai-coding-stack/mcp-servers) to find the right integrations for your workflow.
Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: 'Getting Started with AI Coding: A Comprehensive Guide'
3+
description: 'Learn how to set up your first AI-powered development environment with IDEs, CLIs, and the essential tools you need to boost your coding productivity.'
4+
date: '2025-01-15'
5+
---
6+
7+
The rise of AI-powered coding tools has fundamentally transformed how developers write, debug, and maintain code. Whether you're a seasoned engineer or just starting your coding journey, integrating AI into your development workflow can dramatically boost your productivity and code quality.
8+
9+
## Why AI Coding Matters
10+
11+
Traditional coding involves writing every line manually, looking up documentation, and debugging through trial and error. AI coding assistants change this paradigm by:
12+
13+
- Providing intelligent autocomplete that understands context
14+
- Generating boilerplate code from natural language descriptions
15+
- Catching bugs before they make it to production
16+
- Explaining complex code in plain English
17+
- Suggesting optimizations and best practices
18+
19+
## Choosing Your IDE
20+
21+
Your choice of IDE is crucial for AI coding. The two most popular options are:
22+
23+
### Cursor
24+
25+
Built from the ground up for AI pair programming. Cursor offers native AI chat, inline editing, and codebase-wide understanding. Best for developers who want AI deeply integrated into every aspect of their workflow.
26+
27+
### VS Code + Extensions
28+
29+
Combine the familiar VS Code interface with AI extensions like GitHub Copilot, Codeium, or Tabnine. Best for developers who want to keep their existing setup while adding AI capabilities.
30+
31+
## Setting Up Your First AI Coding Environment
32+
33+
Here's a step-by-step guide to get started:
34+
35+
### 1. Choose Your IDE
36+
37+
Download and install either Cursor or VS Code with your preferred AI extension.
38+
39+
### 2. Configure API Keys
40+
41+
Most AI coding tools require API keys from providers like OpenAI, Anthropic, or DeepSeek. Sign up for an account and generate your keys.
42+
43+
### 3. Practice with Simple Tasks
44+
45+
Start by asking your AI agent to generate simple functions, explain code snippets, or suggest improvements to existing code.
46+
47+
## Next Steps
48+
49+
Once you're comfortable with basic AI coding, explore advanced topics like prompt engineering for better code generation and integrating AI into your CI/CD pipeline.
50+
51+
The AI coding ecosystem is evolving rapidly. Stay updated with the latest tools and best practices through the [AI Coding Stack](/ai-coding-stack) documentation.
Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
---
2+
title: 'Understanding MCP Servers: The Future of AI Context'
3+
description: 'Deep dive into Model Context Protocol servers, how they work, and why they are crucial for building intelligent AI coding assistants that truly understand your project.'
4+
date: '2025-01-10'
5+
---
6+
7+
Model Context Protocol (MCP) servers represent a paradigm shift in how AI agents interact with external tools, data sources, and APIs. They are the connective tissue that transforms isolated AI models into context-aware coding companions that truly understand your project.
8+
9+
## What is MCP?
10+
11+
The Model Context Protocol is an open standard developed by Anthropic that enables AI agents to securely connect to external data sources and tools. Think of MCP servers as specialized adapters that give your AI agent superpowers—whether that's reading from databases, searching the web, interacting with APIs, or accessing your filesystem.
12+
13+
Unlike traditional API integrations that require custom code for each tool, MCP provides a standardized interface. This means any MCP-compatible AI agent can use any MCP server without custom integration work.
14+
15+
## How MCP Servers Work
16+
17+
An MCP server is a lightweight process that exposes three core primitives:
18+
19+
### Resources
20+
21+
Context and data that the AI can read. For example, a filesystem MCP server exposes your project files as resources.
22+
23+
### Tools
24+
25+
Actions the AI can perform. A web search MCP might expose a search tool, while a database MCP could provide query execution tools.
26+
27+
### Prompts
28+
29+
Templated interactions that guide the AI. These can include best practices or common workflows specific to the tool.
30+
31+
## Popular MCP Servers
32+
33+
The MCP ecosystem is rapidly growing. Here are some essential servers:
34+
35+
- **Filesystem** - Access local files and directories
36+
- **Playwright** - Browser automation and web scraping
37+
- **Context7** - Up-to-date library documentation
38+
- **PostgreSQL** - Database queries and schema inspection
39+
- **GitHub** - Repository management and code search
40+
- **Brave Search** - Real-time web search capabilities
41+
42+
## Why MCP Matters for AI Coding
43+
44+
Before MCP, AI coding assistants were essentially blind to your development environment. They could generate code based on training data, but couldn't access your actual project structure, read your configuration files, or interact with your development tools.
45+
46+
MCP changes this fundamentally. With MCP servers, your AI agent can:
47+
48+
- Understand your entire codebase structure through filesystem access
49+
- Look up current documentation for libraries you're using
50+
- Execute database queries to understand your data model
51+
- Search the web for the latest solutions to your specific problem
52+
- Interact with your Git repository to understand commit history
53+
54+
## Getting Started with MCP
55+
56+
Most modern AI coding tools now support MCP. Setting up your first MCP server typically involves:
57+
58+
### 1. Choose an MCP Server
59+
60+
Start with something simple like the filesystem or web search MCP server.
61+
62+
### 2. Install the Server
63+
64+
Most MCP servers are distributed as npm packages or Python modules. Follow the installation instructions for your chosen server.
65+
66+
### 3. Configure Your IDE
67+
68+
Add the MCP server configuration to your IDE's settings. The exact format varies by tool, but typically involves specifying the server's command and any required arguments.
69+
70+
Here's an example configuration for Claude Code:
71+
72+
```json
73+
{
74+
"mcpServers": {
75+
"filesystem": {
76+
"command": "npx",
77+
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/your/project"]
78+
},
79+
"brave-search": {
80+
"command": "npx",
81+
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
82+
"env": {
83+
"BRAVE_API_KEY": "your-api-key-here"
84+
}
85+
}
86+
}
87+
}
88+
```
89+
90+
### 4. Test the Integration
91+
92+
Ask your AI agent to use the newly connected tools. For example, if you installed a filesystem MCP, try asking it to read a specific file from your project.
93+
94+
## The Future of MCP
95+
96+
The MCP ecosystem is still in its early stages, but the potential is enormous. As more developers build MCP servers for specialized tools and services, AI agents will become increasingly powerful and context-aware.
97+
98+
We're moving toward a future where your AI coding assistant has seamless access to every tool in your development workflow—from your IDE to your cloud infrastructure. MCP is the protocol that makes this vision possible.
99+
100+
Explore the full catalog of available MCP servers in our [MCP Servers directory](/ai-coding-stack/mcp-servers) to find the right integrations for your workflow.
Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: 'Getting Started with AI Coding: A Comprehensive Guide'
3+
description: 'Learn how to set up your first AI-powered development environment with IDEs, CLIs, and the essential tools you need to boost your coding productivity.'
4+
date: '2025-01-15'
5+
---
6+
7+
The rise of AI-powered coding tools has fundamentally transformed how developers write, debug, and maintain code. Whether you're a seasoned engineer or just starting your coding journey, integrating AI into your development workflow can dramatically boost your productivity and code quality.
8+
9+
## Why AI Coding Matters
10+
11+
Traditional coding involves writing every line manually, looking up documentation, and debugging through trial and error. AI coding assistants change this paradigm by:
12+
13+
- Providing intelligent autocomplete that understands context
14+
- Generating boilerplate code from natural language descriptions
15+
- Catching bugs before they make it to production
16+
- Explaining complex code in plain English
17+
- Suggesting optimizations and best practices
18+
19+
## Choosing Your IDE
20+
21+
Your choice of IDE is crucial for AI coding. The two most popular options are:
22+
23+
### Cursor
24+
25+
Built from the ground up for AI pair programming. Cursor offers native AI chat, inline editing, and codebase-wide understanding. Best for developers who want AI deeply integrated into every aspect of their workflow.
26+
27+
### VS Code + Extensions
28+
29+
Combine the familiar VS Code interface with AI extensions like GitHub Copilot, Codeium, or Tabnine. Best for developers who want to keep their existing setup while adding AI capabilities.
30+
31+
## Setting Up Your First AI Coding Environment
32+
33+
Here's a step-by-step guide to get started:
34+
35+
### 1. Choose Your IDE
36+
37+
Download and install either Cursor or VS Code with your preferred AI extension.
38+
39+
### 2. Configure API Keys
40+
41+
Most AI coding tools require API keys from providers like OpenAI, Anthropic, or DeepSeek. Sign up for an account and generate your keys.
42+
43+
### 3. Practice with Simple Tasks
44+
45+
Start by asking your AI agent to generate simple functions, explain code snippets, or suggest improvements to existing code.
46+
47+
## Next Steps
48+
49+
Once you're comfortable with basic AI coding, explore advanced topics like prompt engineering for better code generation and integrating AI into your CI/CD pipeline.
50+
51+
The AI coding ecosystem is evolving rapidly. Stay updated with the latest tools and best practices through the [AI Coding Stack](/ai-coding-stack) documentation.

0 commit comments

Comments
 (0)