使用说明
NF-OSI的模型上下文协议(MCP)服务器
一组MCP服务器,使您的AI助手能够访问NF-OSI资源和工具。
可用服务器
nfty python
Synapse数据管理工作流程的快速工具。使AI助手能够:
- 从Synapse数据集中查询和提取元数据
- 根据JSON模式验证元数据
- 将元数据作为Synapse注释提交
- 审查和分类Synapse项目
- 检索数据共享计划
状态: ✅ 生产就绪 语言:Python 3.8+ 依赖项:突触客户端、mcp、请求、jsonschema
记忆 (即将推出)
NF-OSI的机构记忆和知识库。保存:
- 来自官方文档以及Slack等来源的团队历史和设计决策
- 从长期团队成员那里获得的部落知识
- 标准操作程序和常见模式
- 策展决策的历史背景
- 项目特定上下文和对话状态
状态: 🚧 正在开发中 语言:待定
概述
此存储库组织为 单体仓库 包含多个独立的MCP服务器。每台服务器:
- 具有独立的依赖关系
- 可以独立安装和使用
- 可以用不同的编程语言编写
- 遵循MCP协议进行AI辅助集成
快速开始
安装
-
克隆存储库
git clone <repository-url> cd mcp-server -
安装要使用的服务器
每台服务器在其子目录中都有自己的安装说明:
您可以同时安装和使用多个服务器,它们作为独立进程运行。
配置
每个服务器都在MCP客户端中独立配置。您可以启用一个或多个服务器。
适用于克劳德桌面
添加到您的Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"nfty": {
"command": "uvx",
"args": ["--from", "/absolute/path/to/mcp-server", "nfty"],
"env": {
"SYNAPSE_AUTH_TOKEN": "your-synapse-personal-access-token"
}
}
}
}
重要:替换 /absolute/path/to/mcp-server 使用存储库的实际路径。
多服务器示例:
{
"mcpServers": {
"nfty": {
"command": "uvx",
"args": ["--from", "/absolute/path/to/mcp-server", "nfty"],
"env": {
"SYNAPSE_AUTH_TOKEN": "your-synapse-personal-access-token"
}
},
"memory": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/memory/build/index.js"],
"env": {}
}
}
}
备注:每个服务器都作为一个独立的进程运行。您可以通过在配置中添加/删除服务器来启用/禁用它们。
#### For Other MCP Clients
Refer to your client's documentation for MCP server configuration. Each server's configuration follows this pattern:
**For nfty (Python):**
- **Command**: `uvx`
- **Args**: `["--from", "/path/to/mcp-server", "nfty"]`
- **Environment**: `SYNAPSE_AUTH_TOKEN` with your token
**For memory (Node.js example):**
- **Command**: `node`
- **Args**: `["/path/to/mcp-server/memory/build/index.js"]`
- **Environment**: Server-specific env vars
**For compiled servers (Go/Rust example):**
- **Command**: `"/path/to/mcp-server/server-name/bin/executable"`
- **Args**: `[]` (or server-specific args)
- **Environment**: Server-specific env vars
### Verify Installation
Test each server directly:
**nfty:**
```bash
export SYNAPSE_AUTH_TOKEN="your-token"
uvx --from . nfty
服务器将启动并等待MCP协议消息。按Ctrl+C停止。
其他服务器: 有关具体的测试说明,请参阅每台服务器的README。
用法
配置后,您的AI助手可以访问每个启用的服务器提供的漂亮工具。
有关具体功能和使用示例,请参阅每台服务器的文档:
发展
运行测试
测试
- 查看服务器特定目录中的测试
- AI代理测试:
# Requires goose
export SYNAPSE_AUTH_TOKEN=$SYNAPSE_AUTH_TOKEN
goose run --recipe tests/curator_tester.yaml
添加新工具
nfty
- 将工具定义添加到
list_tools()在mcp_server.py - 实现异步处理函数
- 将处理程序添加到
call_tool()调度员 - 更新文档
TOOLS.md - 在中更新测试提示
tests/curator_tester.yaml