内容
# AiCircus — MCP 示例
一些使用 **MCP（模型上下文协议）** 的最小化且可运行的示例服务器，以 TypeScript 和 Python 编写，准备好与 Claude 或其他兼容的客户端连接。由 **[AiCircus](https://aicircus.it)** 维护，**[ShadApps](https://www.shadapps.it)** 的 AI 垂直领域。
> **什么是 MCP？** 模型上下文协议是一种开放标准，允许 AI 模型（如 Claude）以统一的方式使用外部工具 — 读取文件、查询 API、调用您的系统。实际上，它是 AI 代理与您的工具通信的“语言”。深入了解：[MCP：AI 代理的语言](https://aicircus.it/blog/mcp-agenti-claude)。
## 示例
| 示例 | 语言 | 显示内容 |
|---|---|---|
| [`examples/typescript-echo`](examples/typescript-echo) | TypeScript | 通过 stdio 使用官方 SDK `@modelcontextprotocol/sdk` 的最小化 MCP 服务器，以及一个 `echo` 工具。 |
| [`examples/python-echo`](examples/python-echo) | Python | 使用 `FastMCP`（包 `mcp`）的相同服务器。 |
每个示例都公开一个 `echo` 工具，该工具会重复接收到的消息：这是了解 MCP 服务器结构的最简单起点，然后可以发展成真正的工具（文档读取、数据库查询、调用您的 CRM/ERP）。
### TypeScript — 快速启动
```bash
cd examples/typescript-echo
npm install
npm run build && npm start # stdio 上的 MCP 服务器
```
### Python — 快速启动
```bash
cd examples/python-echo
pip install -r requirements.txt
python server.py # stdio 上的 MCP 服务器
```
### 将其连接到 Claude Desktop
将服务器添加到 Claude Desktop 的配置文件 (`claude_desktop_config.json`) 中：
```json
{
"mcpServers": {
"aicircus-echo": {
"command": "python",
"args": ["/绝对路径/examples/python-echo/server.py"]
}
}
}
```
重启 Claude Desktop：`echo` 工具将出现在可用工具中。
## 关于我们
**AiCircus** 是 **ShadApps S.r.l.** （米兰）的 AI 垂直领域。我们为初创公司和中小企业构建定制 AI 代理、流程自动化、MCP 集成和 AI 审计，使用 Claude、GPT 和 Gemini 等模型，无平台锁定。
- 🌐 网站：[aicircus.it](https://aicircus.it) · [English](https://aicircus.it/en)
- 🧩 服务：[AI 服务](https://aicircus.it/servizi) · [意大利 AI 咨询](https://aicircus.it/consulenza-ai)
- 📝 博客：[aicircus.it/blog](https://aicircus.it/blog)
- 🏛️ 集团：[ShadApps](https://www.shadapps.it) · [AppSviluppo](https://www.appsviluppo.com)
如果您想将 MCP 和 AI 代理引入您的流程，[从免费 AI 审计开始](https://aicircus.it/servizi)。
## 许可证
[MIT](LICENSE) — 自由使用、修改和在其基础上构建。
