MCP工具集

通过Model Context Protocol (MCP)连接Claude Desktop与自定义工具和数据源的开发工具集,支持基础计算和便签管理功能。

  • by Anup-repo
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 anup-repo/own-mcp-server

使用说明

🧠 克劳德桌面+MCP工具

此repo演示了如何使用 模型上下文协议(MCP) 将Claude Desktop与您自己的工具和数据源连接。

它包括:

  • main.py:基本的MCP工具(例如,添加数字、问候用户)
  • sticky_note.py:一个迷你便签系统,让克劳德可以创建、更新和获取便签
  • 全部配置为克隆仓库后立即运行

📦 特性

文件 描述
main.py 使用简单工具注册基本MCP服务器
sticky_note.py 带笔记工具的高级MCP服务器
notes.json 便利贴存储文件

🛠 需求


🚀 快速开始

1.克隆存储库

git clone https://github.com/Anup-repo/own-mcp-server.git
cd own-mcp-server

2.设置虚拟环境

python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows

3.安装uv

您可以通过pip安装uv:

pip install uv

官方文件:https://docs.astral.sh/uv/getting-started/installation

4.创建和初始化MCP项目

uv init .
uv add "mcp[cli]"

5.创建MCP服务器

uv run mcp install main.py

6.运行MCP服务器

You’ll now see Demo as a tool in Claude Desktop. Try:

“Add 3 + 2”

7.运行便签服务器(Sticky_Note.py)

uv run mcp install sticky_note.py

🧪 Claude中的示例用例

  1. 创建笔记
  • 问克劳德: 创建10个关于RCB的便利贴。
  1. 获取特定注释 获取ID为3的便利贴。

  2. 探索资源 点击➕ 并选择get_latest_note。 然后问:用5行总结这篇笔记。

  3. 总结所有笔记 点击➕, 选择notes://example,然后运行note_summary。

Claude将使用自定义提示总结您的便签。

🧱 文件结构

mcp-server/
│
├── main.py                # Basic add/greeting tool
├── sticky_note.py         # Sticky note toolset
├── notes.json             # Note storage
├── pyproject.toml         # MCP project metadata
└── README.md              # This file

🛠 故障排除

如果工具未显示在Claude Desktop中:

重新启动克劳德桌面

转到“设置”→ 开发者→ 连接服务器

如果未链接:

单击编辑配置

更新uv的完整路径:

{
  "uv": "/your/full/path/to/uv"
}

您可以使用以下命令找到路径:

which uv       # macOS/Linux
where uv       # Windows

保存、关闭并重新打开Claude Desktop

查看中篇文章了解更多详细信息: 理解MCP:人工智能和外部数据之间的桥梁