项目简介

Coputo 是一个用于构建 Model Context Protocol (MCP) 服务器的 TypeScript 框架。它基于 Node.js 和 Fastify 构建，旨在帮助开发者快速搭建与大型语言模型 (LLM) 客户端通信的上下文服务后端。框架提供了简化工具集成、安全凭证管理等功能。

主要功能点

注册并执行工具： 轻松定义和注册 LLM 可以调用的外部功能（Tools），Coputo 服务器负责接收来自 LLM 客户端的调用请求，执行相应的业务逻辑，并将结果返回。
安全凭证管理： 提供内置机制安全地存储和管理不同租户或适配器所需的 API 密钥等敏感信息。这些凭证可以在工具执行时安全地被工具函数访问，支持自定义存储方案（如数据库）。
支持标准协议： 集成了 Model Context Protocol (MCP) SDK，通过标准的 JSON-RPC 协议进行通信，支持 HTTP/SSE 等传输方式，确保与兼容的 LLM 客户端互操作。
加速开发： 提供 Fastify 插件和核心库，简化 MCP 服务器的搭建、工具的定义以及凭证的处理流程。

安装步骤

确保你的系统已安装 Node.js 和 npm。
打开终端，运行 Coputo 提供的脚手架工具来创建新项目：
```
npm create coputo@latest my-mcp-server
```
请将 'my-mcp-server' 替换为你希望的项目名称。
进入新创建的项目目录：
```
cd my-mcp-server
```
脚手架工具通常会自动安装项目依赖。如果跳过了此步骤，请手动运行：
```
npm install
```

服务器配置 (供MCP客户端配置)

MCP 客户端需要知道如何连接到你的 Coputo 服务器。以下是一个示例的配置信息，通常以 JSON 格式提供给客户端。请根据你实际部署服务器的方式和位置调整其中的参数：

{
  "name": "my-mcp-server", // 这是你的 MCP 服务器的标识名称
  "command": "node",         // 启动服务器进程的命令，通常是 'node'
  "args": ["dist/index.js"]  // 传递给命令的参数，指定要执行的服务器入口文件路径
}

请注意，'dist/index.js' 是 TypeScript 项目编译后的 JavaScript 文件路径。在实际使用时，请确认这个路径是正确的。

基本使用方法

在项目目录中运行以下命令启动你的 Coputo 服务器：
```
npm run dev
```
服务器默认会在 'http://localhost:3000' 监听。
使用任何支持 Model Context Protocol 的 LLM 客户端，配置连接到你的服务器地址 ('http://localhost:3000')。客户端将通过 '/api/mcp' 端点与服务器进行 JSON-RPC 通信，例如发现可用的工具或发起工具调用。

如果你使用了凭证管理功能，可以通过向 '/api/mcpServerAdapterTokens' 端点发送 POST 请求来设置工具所需的凭证（这通常需要身份验证）。示例（需要额外配置身份验证和凭证存储）：

curl -X POST http://localhost:3000/api/mcpServerAdapterTokens \
-H "Content-Type: application/json" \
-d '{"name": "your-tool-name", "token": "your-secret-key"}'

关键词

信息