使用说明

项目简介

'evm-server' 是一个基于 Model Context Protocol (MCP) 构建的示例服务器，它提供了一个简单的文本笔记管理系统。该服务器通过 MCP 协议向客户端暴露资源（笔记）、工具（创建笔记）和 Prompt 模板（总结笔记），展示了如何构建一个符合 MCP 规范的应用后端。

主要功能点

资源 (Resources):
- 以 'note://' URI 格式管理文本笔记。
- 每个笔记包含标题和内容。
- 支持以纯文本 'text/plain' 格式访问笔记内容。
- 客户端可以列出所有笔记资源，并根据 URI 读取指定笔记的内容。
工具 (Tools):
- 提供 'create_note' 工具，用于创建新的文本笔记。
- 创建笔记工具接受标题和内容作为输入参数。
- 新创建的笔记存储在服务器内存中。
Prompt 模板 (Prompts):
- 提供 'summarize_notes' Prompt 模板，用于生成所有笔记的摘要。
- 该 Prompt 模板会将所有笔记的内容作为嵌入资源包含在 Prompt 消息中，以便 LLM 进行总结。

安装步骤

安装 Node.js 和 npm: 确保您的计算机上已安装 Node.js 和 npm (Node 包管理器)。您可以从 nodejs.org 下载并安装。
克隆仓库: 打开终端或命令提示符，使用 'git clone https://github.com/pythonpete32/evm-server.git' 命令将仓库克隆到本地。
进入项目目录: 使用 'cd evm-server' 命令进入克隆下来的项目目录。
安装依赖: 在项目目录下运行 'npm install' 命令安装项目所需的依赖包。
构建项目: 运行 'npm run build' 命令编译 TypeScript 代码，生成可执行的 JavaScript 文件。

服务器配置

要将 'evm-server' 配置为 MCP 服务器供 MCP 客户端使用，您需要在 MCP 客户端的配置文件中添加服务器配置信息。以 Claude Desktop 为例，您需要编辑 Claude Desktop 的配置文件。

配置文件位置通常为：

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

在配置文件中找到 '"mcpServers"' 字段，并添加 'evm-server' 的配置。配置信息是一个 JSON 对象，包含服务器名称 ('evm-server') 和启动命令 ('command')。

例如，在 'claude_desktop_config.json' 文件中添加如下配置：

{
  "mcpServers": {
    "evm-server": {
      "command": "/path/to/evm-server/build/index.js" 
      // 请将 "/path/to/evm-server/build/index.js" 替换为实际的 'evm-server' 项目构建输出文件路径。
      // 例如，如果您的项目克隆在用户主目录下的 "evm-server" 文件夹中，则命令可能类似于 "/Users/yourusername/evm-server/build/index.js" (MacOS) 或 "C:\\Users\\YourUsername\\evm-server\\build\\index.js" (Windows)。
    }
  }
}

请务必根据您的实际项目路径修改 'command' 字段的值。

基本使用方法

启动服务器: 在 'evm-server' 项目目录下，运行命令 'node build/index.js' 启动 MCP 服务器。服务器将通过标准输入/输出 (stdio) 与 MCP 客户端通信。
连接客户端: 配置并启动您的 MCP 客户端（例如 Claude Desktop）。客户端应能自动检测并连接到 'evm-server' 服务器。
使用功能: 在 MCP 客户端中，您应该能够：
- 列出和访问 'evm-server' 提供的笔记资源。
- 调用 'create_note' 工具创建新的笔记。
- 使用 'summarize_notes' Prompt 模板生成笔记摘要。

具体操作方式请参考您使用的 MCP 客户端的文档。

关键词