内容
# 🔌 MCP 服务器
<div align="center">
**从零开始构建的生产级MCP服务器 — 连接大型语言模型到现实世界的工具。**
[概述](#-概述) • [服务器](#-服务器) • [快速入门](#-快速入门) • [架构](#-架构) • [连接](#-连接至-Claude-桌面端)
</div>
---
## 🧠 概述
本仓库包含不断增长的 **模型上下文协议（MCP）服务器** 集合 — 轻量级、调用工具的后端，为Claude等大型语言模型提供结构化的外部能力访问。
MCP 之于 AI 代理就像 REST 之于 Web 应用：一种 **标准化的协议**，用于向语言模型暴露工具、资源和提示。
```
LLM 客户端（Claude 桌面端 / Cursor）
│
│ JSON-RPC via stdio / SSE
▼
MCP 服务器（本仓库）
│
▼
工具逻辑（API、数学、文件、数据库...）
```
---
## 📦 服务器
| 服务器 | 描述 | 工具 | 状态 |
|--------|-------------|-------|--------|
| `my-first-mcp-server` | 使用 FastMCP 的计算器服务器 | `add` | ✅ 已完成 |
| _更多即将到来..._ | | | 🔧 开发中 |
---
## 🚀 快速入门
### erequisites
- Python 3.10+
- `pip install mcp`
### 克隆仓库
```bash
git clone https://github.com/asfandyar-prog/mcp-servers.git
cd mcp-servers
```
### 运行服务器
```bash
cd my-first-mcp-server
python fastmcp_calculator.py
```
> ⚠️ 直接在终端运行将显示 JSON 错误 — 这是 **预期的**。MCP 服务器设计用于与 MCP 客户端通信，而不是终端。请参见下面的 [连接至 Claude 桌面端](#-连接至-Claude-桌面端)。
---
## 🏗 架构
每个服务器都遵循以下结构：
```
mcp-servers/
├── my-first-mcp-server/
│ └── fastmcp_calculator.py # 具有工具定义的 FastMCP 服务器
├── README.md
```
### 如何定义工具
```python
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("my-first-server")
@mcp.tool()
def add(a: int, b: int) -> int:
"""添加两个数字"""
return a + b
mcp.run()
```
就是这样 — FastMCP 自动处理所有 JSON-RPC 管道。
---
## 🖥 连接至 Claude 桌面端
要将任何服务器与 **Claude 桌面端** 一起使用，请将其添加到您的配置文件中：
**位置：** `C:\Users\<YOU>\AppData\Roaming\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"calculator": {
"command": "python",
"args": ["C:\\Users\\<YOU>\\mcp-servers\\my-first-mcp-server\\fastmcp_calculator.py"]
}
}
}
```
重启 Claude 桌面端 → 查找 🔨 锤子图标 → 您的工具已上线。
---
## 🔗 相关仓库
> 更广泛的 AI 工程组合的一部分：
- [`agentic-systems-with-langgraph`](https://github.com/asfandyar-prog/agentic-systems-with-langgraph) — 使用 LangGraph 的多智能体系统
- [`framework-free-agent`](https://github.com/asfandyar-prog/framework-free-agent) — 从零开始的自主 ReAct 代理
- [`DeepLearning`](https://github.com/asfandyar-prog/DeepLearning) — Transformers、CNN，从零开始的实现
---
## 👤 作者
**阿斯凡达·雅尔** — AI 工程师 | 多智能体系统 | 大型语言模型基础设施
[](https://linkedin.com/in/asfand-yar-3966b8291)
[](https://github.com/asfandyar-prog)
[](mailto:asfandyar@mailbox.unideb.hu)
---
<div align="center">
<sub>在匈牙利德布勒森使用 ☕ 构建</sub>
</div>
