我的 MCP 服务器 🛠️

介绍与链接 🔗

MCP 协议使工具和代理能够像 REST API 服务应用程序一样运作。它实现了工具和服务之间的标准化集成与通信。

MCP 让以下组件无缝协作：

• MCP 服务器（工具） - 类似于获取天气数据的服务
• MCP 客户端（代理及应用） - 类似于 OpenWebUI

可以把 MCP 服务器看作是工具的包装器，使它们能够立即被 AI 应用使用。

核心链接 🏁

• MCP 服务器快速入门教程
• 快速入门示例代码库
• 官方 MCP 服务器列表
• 创建 MCP 服务器模板

入门指南

查看 add-note 示例服务器，开始你的第一步。

开发指南 🧑💻

创建新服务器

1. 设置结构

   export MY_SERVER="my-server-name"
   uvx create-mcp-server --name $MY_SERVER --path ./servers/$MY_SERVER
   

2. 安装依赖项

   cd ./servers/$MY_SERVER
   uv sync --dev --all-extras
   cd ../..
   

本地运行

export MY_SERVER="my-server-name"
cd ./servers/$MY_SERVER && uv run $MY_SERVER

开发工具

使用官方的 MCP 检查器 工具监控你的 MCP 服务器：

export MY_SERVER="my-server-name"
npx @modelcontextprotocol/inspector uv --directory ./servers run $MY_SERVER

构建（可选）

cd ./servers/$MY_SERVER
uv sync
uv build
cd ../..

清理

要删除一个服务器：

1. 从成员列表中删除该服务器条目 pyproject.toml。
2. 执行命令：

   rm -r ./servers/$MY_SERVER
   uv sync