关于 mcp-server
mcp-server 是一个用于学习编写 MCP 服务的项目,README 介绍了 Python 环境依赖和客户端配置方式。文档还提及可使用 jina.ai 提供的搜索与网页读取工具。
主要功能
- 01面向 MCP 服务开发学习
- 02提供 Python 与 uv 环境说明
- 03提供客户端配置示例
- 04提及 jina.ai 搜索和网页读取
适用场景
- 01学习 MCP 服务配置
- 02在 Claude Desktop 中安装配置
- 03参考 Python 项目启动方式
- 04了解 jina.ai 工具用途
MCP 相关
这是一个 MCP 服务项目,README 展示了面向客户端的配置示例,并说明其工具涉及 jina.ai 搜索和网页读取。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
README 原文English
来自项目 READMEREADME 暂无中文译文,以下为英文原文;中文介绍见上方。
mcp-server
学习写 mcp server
安装 (cline)
Installing via Smithery
To install mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @yiGmMk/mcp-server --client claude
前置依赖
• Python 3.12 or newer • uv package manager
没有安装uv的,请参考文档uv 安装文档
macos或linux可使用如下命令安装
curl -LsSf https://astral.sh/uv/install.sh | sh
windwos,在powershell下安装
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
配置文件
优先使用下面这种配置方式
{
"mcpServers": {
"yiGmMk/mcp-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/your/mcp-server",
"run",
"main.py"
],
"env": {
"JINA_API_KEY": "jina_api_key,请从https://jina.ai/reader获取",
"GOOGLE_AI_STUDIO_KEY": "Google AI Studio api key,请从https://aistudio.google.com/apikey获取",
"PYTHONIOENCODING": "utf-8"
},
"disabled": false,
"autoApprove": []
}
}
}
或使用venv(增加环境变量配置)
{
"mcpServers": {
"yiGmMk/mcp-server": {
"command": "uv",
"args": [
"run",
"/path/to/your/mcp-server/main.py"
],
"env": {
"VIRTUAL_ENV": "/path/to/your/mcp-server/.venv",
"JINA_API_KEY": "jina_api_key,请从https://jina.ai/reader获取",
"GOOGLE_AI_STUDIO_KEY": "Google AI Studio api key,请从https://aistudio.google.com/apikey获取",
"PYTHONIOENCODING": "utf-8"
},
"disabled": false,
"autoApprove": []
}
}
}
jina.ai
jina.ai提供的各种工具,如搜索,读取网页...
TODO
- 发布到 https://smithery.ai/server/@yiGmMk/mcp-server/tools dockerfile构建成功,但是mcp服务在docker中运行后立即退出,导致无法使用,相关issue: 1.MCP within a Docker Container exits, regardless of lifespan 2. ifespan shuts as soon as it opens
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。