内容
# MCP 开发网络
开发人员社交网络,构建为 MCP 服务器。连接您的 AI 驱动的 IDE 并与其他开发人员互动 — 发送消息,分享资源,发布到公共动态,并通过技术栈发现人员。
---
## 🚀 快速开始
### 1. 注册
```bash
curl -X POST https://mcp-dev-network-production.up.railway.app/auth/signup \
-H "Content-Type: application/json" \
-d '{"email":"you@email.com","password":"yourpassword"}'
```
您将获得一个 token 和 user_id。请保存 token。
### 2. 连接您的 IDE
#### Kiro
编辑 `.kiro/settings/mcp.json`:
```json
{
"mcpServers": {
"dev-network": {
"url": "https://mcp-dev-network-production.up.railway.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
```
#### Cursor
编辑 `.cursor/mcp.json`:
```json
{
"mcpServers": {
"dev-network": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp-dev-network-production.up.railway.app/mcp", "--header", "Authorization: Bearer YOUR_TOKEN"]
}
}
}
```
#### Antigravity (Google)
编辑 `~/.gemini/antigravity/mcp_config.json`:
```json
{
"mcpServers": {
"dev-network": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp-dev-network-production.up.railway.app/mcp", "--header", "Authorization: Bearer YOUR_TOKEN"]
}
}
}
```
#### Claude Desktop
编辑 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"dev-network": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp-dev-network-production.up.railway.app/mcp", "--header", "Authorization: Bearer YOUR_TOKEN"]
}
}
}
```
### 3. 注册您的个人资料
连接后,请您的 AI 助手:
> "使用用户名 `yourname` 和技术栈 `[python, typescript, react]` 注册我的个人资料"
---
## 🛠️ 可用工具
### 个人资料
| 工具 | 描述 | 参数 |
|------|---------------------------|-----------|
| `register` | 创建您的个人资料 | `username`, `stack[]`, `bio` |
| `get_profile` | 查看用户的个人资料 | `username` |
| `search_users` | 按技术栈或名称查找开发人员 | `query?`, `stack?[]` |
### 消息
| 工具 | 描述 | 参数 |
|------|---------------------------|-----------|
| `send_message` | 发送加密的私人消息 | `to_username`, `content` |
| `get_messages` | 读取您的收件箱 | `limit?`, `before_id?` |
### 动态
| 工具 | 描述 | 参数 |
|------|---------------------------|-----------|
| `create_post` | 发布到公共动态 | `content`, `tags?[]` |
| `get_feed` | 读取最近的帖子 | `limit?`, `before_id?`, `tag?` |
### 资源
| 工具 | 描述 | 参数 |
|------|---------------------------|-----------|
| `share_resource` | 分享链接、代码片段或教程 | `title`, `url_or_snippet`, `tags[]` |
| `search_resources` | 按标签或全文搜索 | `tags?[]`, `query?` |
### 版主
| 工具 | 描述 | 参数 |
|------|---------------------------|-----------|
| `report_content` | 举报不适当的内容 | `content_id` (msg_N/res_N), `reason` |
---
## 💬 使用示例
连接后,只需自然地与您的 AI 助手交谈:
| 您说的话 | 使用的工具 |
|-----------------------------|-----------|
| "查找了解 Rust 的开发人员" | `search_users` |
| "给 luis 发送一条消息,说你好" | `send_message` |
| "查看我的消息" | `get_messages` |
| "帖子:刚刚部署了我的第一个 MCP 服务器!" | `create_post` |
| "给我展示最新的帖子" | `get_feed` |
| "分享这个关于 FastAPI 的教程" | `share_resource` |
| "搜索有关 typescript 的资源" | `search_resources` |
---
## 🔒 安全
- **AES-256-GCM** 加密所有私人消息
- **JWT RS256** 身份验证(与 OAuth 2.1 兼容)
- **行级安全** 在 PostgreSQL 中 — 每个用户只能访问他们自己的数据
- **速率限制** — 20 条消息/小时,20 篇帖子/小时,10 个资源/小时
- **不受信任的内容包装器** — 保护免受提示注入
---
## 📡 API 详情
**基准 URL:** `https://mcp-dev-network-production.up.railway.app`
| 端点 | 方法 | 认证 | 描述 |
|----------|--------|------|-------------|
| `/health` | GET | 否 | 健康检查 |
| `/auth/signup` | POST | 否 | 创建帐户,获取 token |
| `/auth/login` | POST | 否 | 登录,获取新鲜 token |
| `/mcp` | POST | Bearer JWT | MCP 工具调用(JSON-RPC 2.0) |
### MCP 请求格式
```json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "tool_name",
"arguments": { ... }
},
"id": 1
}
```
---
## 🏗️ 技术栈
| 层 | 技术 |
|-------|-----------|
| 运行时 | Python 3.11 + FastAPI + uvicorn |
| 数据库 | PostgreSQL(Supabase)带有 RLS |
| 加密 | AES-256-GCM(cryptography) |
| 认证 | JWT RS256(python-jose) |
| 部署 | Railway |
| 协议 | MCP over HTTP Streamable(JSON-RPC 2.0) |
---
## 🤝 贡献
这是一个开放项目。如果您想贡献:
1. 复刻仓库
2. 创建一个功能分支
3. 提交 PR
贡献想法:
- 群组
- 对帖子的反应
- 关注系统
- Web 前端仪表盘
---
## 📄 许可证
MIT