Token导航 LogoToken导航

MCP Server · 文档知识

MCP servers demo

一个演示项目,用于实现具有模块化结构的模型上下文协议(MCP)服务器,支持多种工具和传输方法。

stdio官方级别未说明来源级核验工具 9
PythonClaude知识管理

快速开始

作者 / 组织
aRaafat21
提供方
aRaafat21
运行时
Python

工具数量

9

来源目录标注

资源数量

0

来源目录标注

提示词数量

0

来源目录标注

GitHub Star

0

仓库热度

收录来源

1 个

MCP World

选型结论

MCP servers demo 属于文档知识类 MCP Server,公开资料标注 9 个工具,通过stdio 本地进程接入,适配 Claude,有可以直接复制的安装命令;接入前先确认权限范围。

分类

文档知识

传输方式

stdio

认证方式

无需认证

部署方式

公开资料未说明

安装与配置

安装命令

uv run main.py

公开命令不是通用的启动方式,拼不出可靠配置示例;请在客户端 MCP 配置里按官方文档填写 command 和 args。

上手步骤

  1. 1

    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2

    安装服务

    复制下面的安装命令执行;命令里带占位符的位置换成自己的密钥或路径。

  3. 3

    写入客户端配置

    在客户端的 MCP 配置里填启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4

    验证是否可用

    连接成功后客户端会列出 9 个工具,随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

详细介绍

MCP服务器演示

一个实施模型上下文协议(MCP)服务器的演示项目,该服务器采用模块化结构组织了多种工具。

概述

这个项目展示了如何使用各种工具创建一个具备多种功能的MCP服务器:

  • 一个简单的回显工具直接集成在主模块中
  • 专用模块中的翻译工具
  • 带CRUD操作的笔记资源管理

该服务器支持两者(或:该服务器同时支持……和……) stdio 并且 streamable-http 交通。

项目结构

mcp_servers_demo/
│
├── main.py                # Main MCP server implementation
├── translator/            # Translator tools module
│   ├── __init__.py        # Module exports
│   └── translator_tool.py # Translator tool implementation
├── resources/             # Resources module
│   ├── __init__.py        # Module exports
│   └── note_resource.py   # Notes resource implementation
├── prompts/               # Prompts module
│   ├── __init__.py        # Module exports
│   ├── note_prompts.py    # Notes resource prompts
│   └── translator_prompts.py # Translator tool prompts
├── pyproject.toml         # Project metadata and dependencies
├── README.md              # This file
├── USAGE.md               # Usage guide with examples
├── RESOURCES.md           # Resources documentation
└── PROMPTS.md             # Prompts documentation

可用工具

回声工具

  • echo回传提供的信息

翻译工具

  • translate在不同语言之间翻译文本
  • list_supported_languages列出所有支持的翻译语言

笔记资源工具

  • list_notes列出所有笔记,可选择按标签过滤
  • get_note通过ID获取特定笔记
  • get_note_by_title通过标题查找笔记(精确匹配或部分匹配)
  • create_note创建一个新笔记
  • update_note更新现有笔记
  • delete_note删除一条笔记

安装

这个项目使用了 uv 用于Python包管理。

# Create a virtual environment
uv venv

# Activate the virtual environment
source .venv/bin/activate

# Install dependencies
uv pip install -e .

运行服务器

服务器支持多种传输方法:

stdio 传输(默认)

uv run main.py

可流式传输的HTTP传输

MCP_TRANSPORT=streamable-http uv run main.py

传输配置

运输方式由……决定 MCP_TRANSPORT 环境变量:

  • stdio使用标准输入/输出的默认传输方式
  • streamable-http基于HTTP的传输

MCP资源公司

此项目展示了使用带有标签的Notes资源类型来存储和检索文本笔记的MCP资源。

见 RESOURCES.md 翻译为中文是:“资源文件.md” 关于资源如何实施和使用,详见以下详细信息。

MCP 提示/引导

该项目还展示了使用MCP提示符来增强人工智能与工具之间的交互。提示符为人工智能在使用特定工具时如何格式化请求和响应提供了指导。

我们在整个项目中为各种工具实现了提示功能:

  1. 翻译提示(或:翻译器提示)翻译提示和语言列表工具
  2. “Note Resource Prompts” 可以翻译为“笔记资源提示”或“备注资源提示”,具体取决于上下文和使用场景。如果是在软件或应用程序中提到,可能指的是提供关于如何使用或创建笔记资源的提示或指南笔记管理操作的提示

看 PROMPTS.md(文件名,可译为“提示.md”或保持原样,具体取决于上下文是否需要翻译文件名) 有关提示的实现和使用方法的详细信息。

未来改进方向

  • 与Claude桌面版集成(已配置)

发展

遵循PEP8规范进行代码风格编写。

文档

如需了解更多关于MCP的信息,请查阅官方文档:

工具与能力

工具数量

9

资源数量

0

提示词数量

0

能力标签

MCP服务器Python本地部署模块化工具翻译工具笔记管理AI交互

支持客户端

Claude

数量来自来源目录的标注,具体工具清单以官方文档为准。

典型使用场景

读长文档提问

把 PDF、Markdown 和笔记交给模型,按章节追问细节。

整理知识库

把零散资料归档、打标签,检索时更容易命中。

批量出摘要

提取要点,输出能直接引用的段落。

选择建议

值得选的地方

  • 只提供 9 个工具,职责集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 公开说明写得比较完整,接入前能看清能力边界。

先想清楚的地方

  • stdio 方式要求本地装好 Python,换机器要重新装一遍。
  • 公开摘要偏短,具体能力和限制要回到仓库确认。
  • 第三方目录整理,版本更新和行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

5 个同类
MCP Server工具数传输方式安装命令收录来源最后核验
MCP servers demo

MCP World · 本页

9stdio有1 个2026-05-17
Cherry Studio

MCP World

0未说明未标注1 个2026-05-17
Pdf Math Translate

MCP World

0stdio有1 个2026-05-17
report generation

MCP World

0stdio有1 个2026-05-17
Anything To Notebooklm

MCP World

0stdio有1 个2026-05-17

按同分类和工具数量挑出最接近的几条,字段以各自详情页为准。

常见问题

5 条

MCP servers demo 怎么安装?

公开资料给出的安装命令是 uv run main.py,运行环境为 Python。装完后按客户端要求写进 MCP 配置,重启客户端生效。

MCP servers demo 怎么在 Claude Desktop、Cursor 里配置?

它是stdio 本地进程,客户端配置里要写启动命令和参数,运行环境是 Python;保存后完全退出客户端再打开,配置才会生效。

MCP servers demo 收费吗?

本站只整理公开资料,不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP servers demo 需要 API Key 吗?

公开资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP servers demo 支持哪些客户端?

公开资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

来源信息

继续浏览同类 MCP