NF-OSI资源访问工具集

一组MCP服务器,为AI助手提供访问NF-OSI资源和工具的能力,包括数据查询、元数据验证和知识库管理等功能。

  • by nf-osi
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 nf-osi/mcp-server

使用说明

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辅助集成

快速开始

安装

  1. 克隆存储库

    git clone <repository-url>
    cd mcp-server
    
  2. 安装要使用的服务器

    每台服务器在其子目录中都有自己的安装说明:

    您可以同时安装和使用多个服务器,它们作为独立进程运行。

配置

每个服务器都在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

  1. 将工具定义添加到 list_tools() 在 mcp_server.py
  2. 实现异步处理函数
  3. 将处理程序添加到 call_tool() 调度员
  4. 更新文档 TOOLS.md
  5. 在中更新测试提示 tests/curator_tester.yaml