Model Context Protocol (mcp) 16r

🚀 模型上下文指南

本项目提供了模型上下文协议相关的工具和服务，帮助用户通过自然语言与系统进行交互，实现文件操作、网页内容处理、系统命令执行等功能。

🚀 快速开始

项目结构

- mcp/
- clients/
- mcp-client/
- langchain_mcp_client_wconfig.py
- theailanguage_config.json
- .env
- servers/
- terminal_server/
- memory_server/

本地设置指南

先决条件

• Python 3.9+
• Node.js 16+
• Google API Key
• UV 包管理器

安装步骤

1. 克隆仓库：

git clone https://github.com/Techiral/mcp.git
cd mcp

2. 创建并激活 Python 环境：

python -m venv venv
# Linux/Mac:
source venv/bin/activate
# Windows:
.\venv\Scripts\activate
pip install -r requirements.txt

3. 配置环境变量：

echo "GOOGLE_API_KEY=your_key_here" > clients/mcp-client/.env
echo "THEAILANGUAGE_CONFIG=clients/mcp-client/theailanguage_config.json" >> clients/mcp-client/.env

4. 安装 Node.js 服务器：

npm install -g @modelcontextprotocol/server-memory @modelcontextprotocol/server-filesystem

验证检查列表

• [x] 仓库已克隆
• [x] Python 虚拟环境创建并激活
• [x] Python 依赖项安装完成
• [x] .env 文件配置完成
• [x] Node.js 服务器安装完成

💻 使用示例

基础用法

1. 启动客户端：

python clients/mcp-client/langchain_mcp_client_wconfig.py

2. 输入自然语言请求并接收响应。

命令示例

文件操作

创建名为 example.txt 的文件
搜索所有 Python 文件中的 "function"
计算 main.py 中的行数

网页内容

总结 https://example.com
提取新闻站点的头条新闻

系统命令

列出当前目录中的文件
检查 Python 版本
运行 git status

内存操作

记住我的最爱颜色是蓝色
显示设置的偏好设置
显示最近的命令

📚 详细文档

服务器配置

关键配置文件

• theailanguage_config.json：主要服务器配置文件
• .env：环境变量文件

示例服务器配置

{
"terminal_server": {
"command": "uv",
"args": ["run", "servers/terminal_server/terminal_server.py"]
},
"memory": {
"command": "npx.cmd",
"args": ["@modelcontextprotocol/server-memory"],
"port": 3000
}
}

故障排除

常见问题

1. 网络连接问题：

   • 检查网络是否正常。
   • 确保服务器正在运行。

2. 依赖项未安装：

   • 检查并安装所有必要的包。

3. 配置文件错误：

   • 确保配置文件格式正确。
   • 检查环境变量是否设置正确。

如何贡献

提交代码

1. 创建功能分支：

git checkout -b feature/new-feature

2. 提交更改：

git add .
git commit -m "添加新功能"

3. 推送到远程仓库：

git push origin feature/new-feature

4. 创建拉取请求到主分支。

问题报告

1. 创建问题报告：

   • 描述问题。
   • 提供复现步骤。

2. 提交 Pull Request：

   • 包含修复代码。
   • 解释修复内容。

模型上下文协议

协议说明

• 数据格式：JSON
• 通信方式：HTTP
• 接口版本：1.0

示例接口调用

POST /api/v1/model_context HTTP/1.1
Content-Type: application/json

{
"model_id": "gpt-3",
"context": {
"user_input": "如何使用Python？"
}
}

术语表

感谢使用模型上下文指南！如需更多信息，请访问我们的文档页面。