🔥 K-God MCP 服务器
 ](https://github.com/Chieji/k-god-mcp/actions/workflows/docker-publish.yml)  
适用于Claude桌面版、VSCode和AI助手的多API集成服务器
通过单一的MCP服务器访问20多个API,同时支持(两者/两种方式) .env 文件配置以及一个美观的网页用户界面来管理您的API密钥。
______________________________________________________________________
🚀 特性
20个API集成
免费/廉价的大型语言模型(LLMs) (6个API)
- ✅ Cohere(可译为“一致性”或根据上下文具体翻译为“凝聚力”、“协同性”等,此处保留原英文以体现技术或品牌名称的专有性) - 免费嵌入、聊天、重新排序
- ✅ Groq - 免费超快速推理(Llama、Mixtral、Gemma)
- ✅ DeepInfra(可译为“深度基础设施”或根据具体语境译为“深度技术平台”等,这里保持原英文形式以体现专有名词) - 最便宜的推理费率
- ✅ SambaNova(注:这是一个专有名词,通常不进行翻译,直接保留原样,但如果需要解释性翻译,可以译为“桑巴诺瓦”或根据具体语境调整) - 提供免费层级
- ✅ Google Gemini - 丰厚的免费套餐
- ✅ OpenRouter - 访问100多个模型(部分免费)
高级大型语言模型(LLMs) (2个API)
- ✅(对号,表示正确、确认或同意) OpenAI(开放人工智能研究所) - GPT-4,嵌入表示(或向量表示),DALL-E
- ✅ 表示“正确”或“已确认”。 “Anthropic Claude”可以翻译为“安萨提克·克劳德”(注:这里的“克劳德”是根据英文原名Claude音译而来,实际翻译时可能需要根据具体语境或品牌命名习惯进行调整,但此处提供一个直接的音译版本)。不过,需要注意的是,“Anthropic”是一个公司名,其官方中文译名可能为“安萨提克”或根据官方提供的中文名称来翻译,而“Claude”在这里可能指的是该公司开发的某个AI模型或技术,具体翻译还需结合上下文或官方说明。如果“Claude”是特定模型或技术的名称,且已有官方中文译名,则应使用该译名 - 克劳德模型
搜索与数据 (3个应用程序编程接口)
- ✅ Tavily(音译,具体含义需根据上下文确定,可能是一个品牌名、项目名或特定术语) - AI优化搜索
- ✅ Serper.dev - 谷歌搜索API
- ✅ OpenWeather(开放天气) - 天气数据
基础设施 (4个API)
- ✅(对勾符号,常用于表示正确、同意或确认) Supabase(可译为“苏帕巴斯”或根据具体语境保留原名) - 数据库,认证,存储
- ✅ GitHub - 回购操作,发行问题
- ✅ 表示“正确”或“对”的意思。 Google Cloud(谷歌云) - 存储、BigQuery 等。
- ✅ Ngrok - 隧道管理
专用人工智能 (2个API)
- ✅ 复制 - 机器学习模型托管
- ✅ Jina AI(或译为“吉娜人工智能”) - 嵌入表示与重排序
自动化 (3个应用程序编程接口)
- ✅ Steel.dev(注:直接翻译为“钢铁.dev”可能不够自然,通常在这种域名或项目名称的翻译中,我们会保留“.dev”作为技术或开发相关的标识,因此“Steel.dev”可以理解为一个与钢铁或钢铁行业相关的开发项目或平台的名称,但具体翻译可能需根据上下文调整,此处提供一个较为通用的翻译) - 浏览器自动化
- ✅ Notion(可译为“诺申”或直接保留原名,根据语境决定是否音译) - 知识库
- ✅ 翻译成中文是:✓(正确/对) 上下文7 API上下文管理
______________________________________________________________________
📦 安装
先决条件
- Python 3.11及以上版本
- pip 或 Docker
选项1:直接安装
# Clone or navigate to project
cd k-god-mcp
# Install dependencies
pip install -r requirements.txt
# Copy environment template
cp .env.example .env
# Edit .env with your API keys (or use the Config UI)选项2:安装Docker
# Build and run with Docker Compose
docker-compose up -d
# Or build manually
docker build -t k-god-mcp .
docker run -v $(pwd)/.env:/app/.env k-god-mcp______________________________________________________________________
🔧 配置
选项A:配置用户界面(推荐)
- 启动配置用户界面:
python config_ui.py- 打开浏览器以
http://localhost:3000
- 通过美观的网页界面添加您的API密钥
- 一键测试每个API连接
- 密钥会自动保存到
.env
选项B:手动创建.env文件
编辑 .env 直接文件传输:
# Free LLMs
COHERE_API_KEY=your_key_here
GROQ_API_KEY=your_key_here
GOOGLE_API_KEY=your_key_here
# Premium LLMs
OPENAI_API_KEY=your_key_here
ANTHROPIC_API_KEY=your_key_here
# Search
TAVILY_API_KEY=your_key_here
SERPER_API_KEY=your_key_here
# Infrastructure
GITHUB_TOKEN=your_token_here
SUPABASE_URL=your_url_here
SUPABASE_KEY=your_key_here
# ... etc______________________________________________________________________
🔌 连接到Claude桌面版
1. 编辑Claude桌面配置
macOS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
code %APPDATA%\Claude\claude_desktop_config.jsonLinux:
code ~/.config/Claude/claude_desktop_config.json2. 添加MCP服务器
{
"mcpServers": {
"k-god": {
"command": "python",
"args": ["/absolute/path/to/k-god-mcp/server.py"],
"env": {}
}
}
}或者使用虚拟环境:
{
"mcpServers": {
"k-god": {
"command": "/path/to/venv/bin/python",
"args": ["/path/to/k-god-mcp/server.py"]
}
}
}3. 重启Claude桌面应用
退出并重新打开Claude Desktop。K-God MCP服务器现在可用!
______________________________________________________________________
🔌 连接到 VSCode(Cascade/Cline)
1. 安装MCP扩展
在VSCode中安装MCP扩展(如果可用),或者使用Cascade/Cline设置。
2. 添加到设置
打开VSCode设置并添加:
{
"mcp.servers": {
"k-god": {
"command": "python",
"args": ["/absolute/path/to/k-god-mcp/server.py"]
}
}
}______________________________________________________________________
🎯 使用示例
在Claude Desktop中:
"Use groq_chat to answer: What is quantum computing?"
"Search the web with tavily_search for latest AI news"
"Generate an embedding with cohere_embed for this text: [your text]"
"Check weather_current for New York"
"Create a GitHub issue with github_create_issue in my repo"
"Query my Supabase database with supabase_query"列出可用的API:
"Use list_configured_apis to see what's available"测试连接:
"Use test_api_connection to test the groq API"______________________________________________________________________
🛠️ 可用工具
跑 python server.py 并且使用 list_configured_apis 工具,用于查看基于您配置的API的所有可用工具。
样本工具:
大型语言模型(LLM)工具
openai_chat- 与GPT模型聊天anthropic_chat- 与克劳德聊天groq_chat- 与Groq进行超快速聊天cohere_chat- 与Cohere聊天gemini_generate- 使用Gemini生成
搜索工具
tavily_search- 人工智能搜索serper_search- 谷歌搜索weather_current- 当前天气weather_forecast- 天气预报
数据库工具
supabase_query- 查询Supabasesupabase_insert- 插入到Supabasesupabase_update- 更新Supabase
GitHub 工具
github_repo_info- 获取仓库信息github_create_issue- 创建问题github_search_repos- 搜索仓库
以及40多个其他工具。。。
______________________________________________________________________
🐳 Docker 部署
运行MCP服务器:
docker-compose up mcp-server -d运行配置用户界面:
docker-compose up config-ui -d同时运行两者:
docker-compose up -d查看日志:
docker-compose logs -f mcp-server______________________________________________________________________
🔒 安全注意事项
- API密钥存储在
.env(已添加到.gitignore) - ✅ 永远不要提交(代码/更改)
.env这个短语“to git”在英语中并不是一个常见的固定表达,但根据语境,我们可以将其翻译为“去获取”或“去获得”,具体取决于上下文中的含义。如果“git”在这里是作为动词使用,表示获取或获得的意思,那么翻译就是这样的。不过,需要注意的是,“git”作为动词并不常见,通常它作为名词使用,表示“笨蛋”或“糟糕的人” - ✅ 配置用户界面加密敏感数据
- ✅ 在生产环境中使用环境变量
- ✅ 定期更换钥匙
______________________________________________________________________
🧪 测试
测试单个API:
python -c "
from config import get_settings
from tools.ai.groq_tools import groq_tools
import asyncio
async def test():
result = await groq_tools.test_connection()
print(result)
asyncio.run(test())
"测试所有已配置的API:
使用位于……的配置用户界面(Config UI) http://localhost:3000 并点击每个API的“测试”按钮。
______________________________________________________________________
📝 开发
项目结构:
k-god-mcp/
├── server.py # Main MCP server
├── config_ui.py # Web UI for configuration
├── requirements.txt # Python dependencies
├── .env.example # Template for API keys
├── config/
│ └── settings.py # Settings management
├── tools/
│ ├── ai/ # AI/LLM integrations
│ ├── search/ # Search APIs
│ ├── infrastructure/ # Cloud & dev tools
│ ├── specialized/ # Specialized AI
│ └── automation/ # Automation tools
├── Dockerfile
├── docker-compose.yml
└── README.md添加新API集成:
- 在适当的位置创建工具文件
tools/子目录 - 实施
is_configured,test_connection(),以及get_tools()方法 - 添加到
server.py工具注册表 - 添加环境变量到
.env.example - 更新配置UI映射
config_ui.py
______________________________________________________________________
🤝 贡献(或:参与贡献)
欢迎添加更多API集成!请遵循现有模式:
- 创建扩展工具类
BaseAPITool - 实现所需方法
- 在服务器上注册
- 更新文档
______________________________________________________________________
📄 许可证
MIT 许可证 - 自由使用!
______________________________________________________________________
🆘 故障排除
API密钥未配置
- 检查
.env文件具有正确的键名 - 验证密钥不为空
- 使用配置界面测试连接
“模块未找到”
pip install -r requirements.txtClaude Desktop 无法检测到服务器
- 在配置中使用绝对路径
- 完全重启Claude桌面版
- 检查Python路径是否正确
配置用户界面未加载
# Make sure port 3000 is not in use
lsof -ti:3000 | xargs kill -9
# Then restart
python config_ui.py______________________________________________________________________
🎉 致谢
设计旨在实现最大灵活性和易用性。可与以下系统集成:
- Claude Desktop(Anthropic出品)
- VSCode MCP 扩展
- 任何兼容MCP的客户端
______________________________________________________________________
API整合愉快! 🔥(火)
如遇问题或疑问,请先检查您的API密钥配置,然后使用配置界面测试各个API。
