使用说明

项目简介

Fastn MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型 (LLM) 提供动态工具注册和执行能力。它作为 LLM 和 Fastn 平台之间的桥梁，允许 LLM 通过标准化的 MCP 协议调用 Fastn 平台上的各种工具和服务，从而扩展 LLM 的功能边界，使其能够与外部世界进行更丰富的交互。

主要功能点

动态工具注册: 从 Fastn 平台获取可用工具的定义，并将其动态注册到 MCP 服务器中，无需重启服务器即可更新工具列表。
工具执行: 接收来自 LLM 客户端的工具调用请求，通过 Fastn 平台执行相应的工具，并将结果返回给客户端。
集成 Fastn 平台: 无缝对接 Fastn 平台，利用 Fastn 平台丰富的连接器和 API，扩展 LLM 的应用场景，例如访问 Slack、Notion、HubSpot 等服务。
标准化 MCP 协议: 遵循 MCP 协议规范，确保与任何兼容 MCP 协议的 LLM 客户端互操作。
易于部署和使用: 提供简便的 pip 包安装方式和详细的配置指南，方便用户快速部署和集成到现有的 LLM 工作流中。
日志记录与错误处理: 提供全面的日志记录和错误处理机制，方便问题排查和系统监控。

安装步骤

推荐使用 pip 包安装:

确保你的 Python 环境为 3.10 或更高版本。

打开终端或命令提示符，运行以下命令安装 'fastn-mcp-server' 包:

pip install fastn-mcp-server

手动安装 (如果您需要自定义或开发):

克隆 GitHub 仓库到本地:

git clone https://github.com/fastnai/mcp-fastn
cd mcp-fastn

安装必要的 Python 包：
```
pip install -e .
```

服务器配置

MCP 客户端（如 Claude、Cursor）需要配置 MCP 服务器的启动命令和参数才能连接。以下是配置示例，请根据您的安装方式选择合适的配置，并替换占位符为您实际的值。

配置信息 (JSON 格式):

{
    "mcpServers": {
        "fastn": {
            "command": "/path/to/fastn-mcp-server",  //  fastn-mcp-server 命令的路径 (如果是手动安装，则为 uv 或 python 解释器路径)
            "args": [
                "--api_key",
                "YOUR_API_KEY",      //  您的 Fastn API Key，请在 Fastn 平台获取
                "--space_id",
                "YOUR_WORKSPACE_ID"  //  您的 Fastn Workspace ID，请在 Fastn 平台复制
            ]
        }
    }
}

参数说明:

'server name': 为您的 MCP 服务器指定一个名称，例如 "fastn"。
'command': MCP 服务器的启动命令。
- pip 包安装: 通常为 'fastn-mcp-server' (可能需要使用 'which fastn-mcp-server' 或 'where fastn-mcp-server' 查找完整路径)。
- 手动安装: 如果您使用 'uv' 运行，则为 '/path/to/your/uv'，如果您直接使用 'python' 运行 'fastn-server.py'，则为 '/path/to/your/python'。
'args': 启动命令的参数列表。
- '--api_key': 必需参数，您的 Fastn API Key，用于服务器向 Fastn 平台进行身份验证。
- '--space_id': 必需参数，您的 Fastn Workspace ID，指定 Fastn 工作空间。

不同 MCP 客户端的配置方法:

Claude: 编辑 Claude 的配置文件 'claude_desktop_config.json'，添加上述 'mcpServers' 配置。配置文件的路径通常为：
- macOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
Cursor: 打开 Cursor 设置，在 "MCP" 选项中点击 "Add New"，然后按照提示填写服务器名称、类型（Command）和命令，命令内容即为上述 'command' 和 'args' 组合。

基本使用方法

启动 Fastn MCP Server:

pip 包安装: 在终端或命令提示符中运行：

fastn-mcp-server --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID

手动安装: 在项目根目录下运行：

uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID

请替换 'YOUR_API_KEY' 和 'YOUR_WORKSPACE_ID' 为您实际的值。

配置 MCP 客户端: 根据您使用的 LLM 客户端（如 Claude、Cursor）的文档，配置 MCP 服务器连接信息，将上述 服务器配置 中的 JSON 代码添加到客户端的配置文件或设置中。
在 LLM 中使用工具: 配置完成后，LLM 客户端应该能够检测到 Fastn MCP Server 提供的工具。您可以在 LLM 的交互界面中，通过特定的方式（例如 @ 符号或特定的命令）调用这些工具，以扩展 LLM 的能力。具体工具的使用方法和参数，请参考 Fastn 平台的工具文档。

注意: 首次启动服务器时，Fastn MCP Server 会从 Fastn 平台拉取工具列表并注册。请确保您的 API Key 和 Workspace ID 正确配置，并且您的网络连接正常。

关键词