AI导哈

多工具控制协议服务器

一个支持笔记管理、天气搜索、新闻搜索、文档摄取和RAG查询的多工具控制协议服务器。

  • by KaushalprajapatiKP
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kaushalprajapatikp/custom-mcp-servers

使用说明

带RAG和工具的自定义MCP服务器

该项目实现了 自定义MCP（多工具控制协议）服务器 使用 FastMCP，支持：

  • 备注管理（添加/读取/汇总备注）
  • 天气搜索（通过WeatherAPI）
  • 勇敢的新闻搜索（通过勇敢的API）
  • 文件摄入和RAG查询（通过GroundX）
  • OpenAI GPT集成用于摘要和RAG

特性

  • 在本地附加、阅读和总结文本注释
  • 获取实时天气信息
  • 通过Brave API搜索当前新闻标题
  • 使用GroundX摄取PDF并执行基于RAG的语义搜索
  • 支持OpenAI GPT（例如。， gpt-4o)竣工
  • 用于测试/调试的本地MCP检查员

安装

1.使用 uv （推荐）

uv lock
uv sync

2.使用pip

pip install -r requirements.txt

环境变量(.env)

OPENAI_API_KEY=your_openai_api_key
GROUNDX_API_KEY=your_groundx_api_key
WEATHER_API_KEY=your_weatherapi_key
BRAVE_API_KEY=your_brave_api_key
BUCKET_ID=your_groundx_bucket_id

运行MCP服务器

开发模式（带检查器UI）

mcp dev main.py

如果遇到身份验证错误，请使用以下命令运行：

DANGEROUSLY_OMIT_AUTH=true mcp dev main.py

claude桌面应用开发模式：

mcp install main.py
mcp run main

可用工具和资源

工具名称 描述
add_note(message) 将注释附加到本地文件
read_notes() 归还所有已存储的钞票
note_summary_prompt() 使用GPT生成总结笔记的提示
brave_search_results(q) 通过勇敢搜索API获得最新消息
fetch_weather(city) WeatherAPI提供的实时天气
ingest_documents(path) 将PDF上传到GroundX知识库
process_search_query(q) 使用OpenAI GPT完成执行RAG搜索
search_doc_for_rag_context(q) 检索GPT查询的上下文文本

API示例（通过Inspector）

{
  "tool": "fetch_weather",
  "args": {
    "city": "New York"
  }
}

工作流示例

uv sync
cp .env.example .env  # setup .env file
mcp dev main.py       # start MCP development server

故障排除

错误： Connection Error - Missing Proxy Token

➡️ 解决方案：使用提供的URL或运行：

DANGEROUSLY_OMIT_AUTH=true mcp dev main.py

许可证

MIT许可证 ©2025您的姓名/您的组织

生成于❤️ 使用MCP、GroundX、OpenAI。

相关 MCP