使用说明
MCP服务器-Rust实现
Rust中MCP(模型上下文协议)服务器实现的集合,旨在与AI代理和 分销框架.
概述
此工作区包含多个MCP服务器实现,每个实现都为不同的用例提供专门的功能:
可用的MCP服务器
| 服务器 | 状态 | 描述 | 工具 | 资源 | 用例 |
|---|---|---|---|---|---|
| 麦哲伦 | 🔧 正在进行的工作 | Tavilly搜索API集成 | search, search_news, get_extract |
tavily://search/{query} |
人工智能网络搜索、新闻聚合 |
| mcp编码器 | 🔧 正在进行中 | 文件系统操作、代码分析和格式化 | read_file, write_file, search_files, list_directory, get_project_structure |
file://{path}, directory://{path} |
代码开发、文件管理、项目分析 |
| mcp推特 | 🔧 正在进行的工作 | Twitter/X API集成 | post_tweet, search_tweets, get_user_info, get_user_timeline, get_tweet_analytics |
twitter://user/{id}, twitter://tweet/{id}, twitter://trends/{location} |
社交媒体自动化、内容发布、分析 |
| mcp爬行 | 🔧 正在进行中 | 使用spider-rs进行高级网络爬行 | scrape |
spider://scrape/{url} |
Web数据提取、站点映射、内容分析 |
| mcp reddit | 🔧 正在进行的工作 | Reddit API集成 | get_posts, search_posts, get_comments, get_subreddit_info, get_user_info, get_trending_subreddits, get_user_posts, get_user_comments |
reddit://posts, reddit://comments, reddit://subreddits, reddit://users |
社交媒体监控、内容分析、社区洞察 |
安装
从源头构建
# Clone the repository
git clone https://github.com/your-org/mcp-servers
cd mcp-servers
# Build all servers
cargo build --release
# Or build individual servers
cargo build --release --bin mcp-coder
cargo build --release --bin mcp-twitter
cargo build --release --bin mcp-crawl
cargo build --release --bin mcp-tavily
cargo build --release --bin mcp-reddit
与MCP客户端集成
克劳德桌面
添加到您的Claude Desktop配置中:
{
"mcpServers": {
"coder": {
"command": "/path/to/mcp-servers/target/release/mcp-coder",
"args": ["--directory", "/path/to/your/project"]
},
"twitter": {
"command": "/path/to/mcp-servers/target/release/mcp-twitter",
"env": {
"TWITTER_API_KEY": "your_key",
"TWITTER_API_SECRET": "your_secret",
"TWITTER_BEARER_TOKEN": "your_bearer_token"
}
},
"spider": {
"command": "/path/to/mcp-servers/target/release/mcp-crawl",
"args": ["--stealth-mode"]
},
"crawler": {
"command": "/path/to/mcp-servers/target/release/mcp-crawler"
},
"tavily": {
"command": "/path/to/mcp-servers/target/release/mcp-tavily",
"env": {
"TAVILY_API_KEY": "your_api_key"
}
},
"reddit": {
"command": "/path/to/mcp-servers/target/release/mcp-reddit",
"env": {
"REDDIT_CLIENT_ID": "your_client_id",
"REDDIT_CLIENT_SECRET": "your_client_secret",
"REDDIT_USER_AGENT": "YourAppName/1.0 (by /u/YourUsername)"
}
},
"kg": {
"command": "/path/to/mcp-servers/target/release/mcp-kg",
"args": ["--data-path", "/path/to/kg/data"]
}
}
}
distri框架集成
这些服务器是专门为与 分销框架distri框架提供了一个分布式计算平台,在该平台上,这些MCP服务器可以用作各种任务的工具。
与distri一起使用
-
安装配电盘框架:
# Follow installation instructions from distri repository git clone https://github.com/distrihub/distri -
在district中配置MCP服务器:
# distri-config.yaml mcp_servers: - name: coder command: mcp-coder args: ["--directory", "{{workspace}}"] - name: twitter command: mcp-twitter env: TWITTER_BEARER_TOKEN: "{{secrets.twitter_bearer}}" - name: spider command: mcp-crawl args: ["--stealth-mode"] - name: tavily command: mcp-tavily env: TAVILY_API_KEY: "{{secrets.tavily_key}}" - name: reddit command: mcp-reddit env: REDDIT_CLIENT_ID: "{{secrets.reddit_client_id}}" REDDIT_CLIENT_SECRET: "{{secrets.reddit_client_secret}}" REDDIT_USER_AGENT: "MCP-Reddit-Server/1.0" - name: kg command: mcp-kg args: ["--data-path", "{{workspace}}/knowledge_graph"]
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用,添加测试
- 跑
cargo test和cargo clippy - 提交拉取请求
MCP调试
所有服务器均支持MCP推荐的调试工具 模型上下文协议文档.
使用MCP检查器
# Install MCP Inspector (if not already installed)
npm install -g @modelcontextprotocol/inspector
# Debug any server
npx @modelcontextprotocol/inspector ./target/release/mcp-coder
npx @modelcontextprotocol/inspector ./target/release/mcp-twitter
npx @modelcontextprotocol/inspector ./target/release/mcp-crawl
npx @modelcontextprotocol/inspector ./target/release/mcp-tavily
npx @modelcontextprotocol/inspector ./target/release/mcp-reddit
使用stdio进行手动测试
您可以通过发送JSON-RPC消息手动测试服务器:
# Start server in debug mode
./target/release/mcp-coder --debug
# Send initialization message
echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0"}}}' | ./target/release/mcp-coder
# List available tools
echo '{"jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {}}' | ./target/release/mcp-coder
许可证
此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。
相关项目
- 分销框架 -AI代理框架
- 模型上下文协议 -MCP官方文件
- MCP TypeScript SDK -TypeScript实现
