My First Ia

MCP CLI 翻译为中文是“MCP 命令行界面”

一个用于与MCP（模型上下文协议）服务器交互的命令行界面。这个读取-求值-打印循环（REPL）允许您连接到多个MCP服务器，探索它们的功能，并与它们的工具、资源和提示进行交互。

特点/特性

• 🤖 表示机器人。 AI聊天模式 - 与能够使用您的MCP工具的Claude AI聊天
• 🔌 同时连接到多个MCP服务器
• 🔄 支持stdio和HTTP传输方式
• 🛠️ 交互式工具调用
• 📚 资源阅读
• 💬 提示管理
• 📝 配置持久化
• 🎨 色彩丰富，用户友好的界面

安装

npm install
npm run build

使用方法/用法

开发模式

在开发模式下运行CLI并启用热重载：

npm run dev

生产模式

构建并运行编译后的版本：

npm run build
npm start

直接执行

构建完成后，您也可以运行：

node dist/index.js

配置

CLI（命令行界面）使用一个 mcp-config.json 用于存储服务器配置的文件。您可以手动创建此文件或使用交互式方式 add-server 命令。

示例配置

{
  "servers": [
    {
      "name": "my-stdio-server",
      "transport": "stdio",
      "command": "node",
      "args": ["path/to/server.js"]
    },
    {
      "name": "my-http-server",
      "transport": "http",
      "url": "http://localhost:3000/mcp"
    }
  ]
}

可用命令

服务器管理

• list-servers 或者 ls - 列出所有已配置的服务器及其连接状态
• add-server - 交互式地添加新的服务器配置
• remove-server - 从配置中移除服务器
• connect - 连接到已配置的服务器
• disconnect - 从服务器断开连接

MCP运营（或：MCP操作）

• list-tools - 列出服务器上所有可用的工具
• list-resources - 列出服务器上所有可用的资源
• list-prompts - 列出服务器上所有可用的提示
• call-tool - 在服务器上交互式地调用工具
• read-resource - 从服务器读取资源
• get-prompt - 从服务器获取提示

AI聊天

• chat - 启动带有工具访问权限的AI聊天模式
• /exit-chat - 退出聊天模式（当处于聊天时）
• /clear-history - 清除聊天历史记录（在聊天时）

要求： 设置 ANTHROPIC_API_KEY 环境变量

export ANTHROPIC_API_KEY=your-api-key-here

见 AI_CHAT_GUIDE.md 翻译为中文是：“AI聊天指南.md” 请参阅详细的使用说明。

将军

• help - 显示帮助信息，列出所有可用命令
• exit 或者 quit - 退出REPL（交互式解释器）

示例工作流程

工作流程1：AI聊天模式

1. 设置您的API密钥：

   export ANTHROPIC_API_KEY=your-api-key-here

1. 启动命令行界面（CLI）：

   npm run dev

1. 进入聊天模式：

   mcp> chat

1. 自然聊天：

   chat> Can you create a note titled "Ideas" with content "Build a mobile app"?

   🤔 Thinking...
   🔧 Using tool: memory__create-note
   ✓ Tool executed successfully

   🤖 Assistant:
   I've created a note titled "Ideas" with the content "Build a mobile app".

1. 退出聊天：

   chat> /exit-chat

工作流2：直接使用工具

1. 启动REPL：

   npm run dev

1. 添加服务器：

   mcp> add-server
   Server name: my-server
   Transport (stdio/http): stdio
   Command: node
   Arguments (space-separated, optional): server.js
   Connect now? (y/n): y

1. 列出可用工具：

   mcp> list-tools my-server

1. 调用一个工具：

   mcp> call-tool my-server
   Tool name: add
   Arguments (JSON): {"a": 5, "b": 3}

1. 列出资源：

   mcp> list-resources my-server

1. 阅读一篇资源文章：

   mcp> read-resource my-server
   Resource URI: config://app

创建您自己的MCP服务器

要测试这个命令行界面（CLI），你可以创建一个简单的MCP服务器。以下是一个最小示例：

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';

const server = new McpServer({
  name: 'example-server',
  version: '1.0.0'
});

server.registerTool(
  'add',
  {
    title: 'Add Numbers',
    description: 'Add two numbers together',
    inputSchema: { a: z.number(), b: z.number() },
    outputSchema: { result: z.number() }
  },
  async ({ a, b }) => {
    const output = { result: a + b };
    return {
      content: [{ type: 'text', text: JSON.stringify(output) }],
      structuredContent: output
    };
  }
);

const transport = new StdioServerTransport();
await server.connect(transport);

将此保存为 example-server.ts 并使用以下命令运行它：

npx tsx example-server.ts

然后在MCP CLI中进行配置：

{
  "servers": [
    {
      "name": "example",
      "transport": "stdio",
      "command": "npx",
      "args": ["tsx", "example-server.ts"]
    }
  ]
}

建筑

该项目的结构如下：

• src/index.ts - 入口点
• src/repl.ts - REPL接口和命令处理
• src/server-manager.ts - MCP服务器连接管理
• src/config.ts - 配置文件管理
• src/types.ts - TypeScript 类型定义

依赖项

• @modelcontextprotocol/sdk - 官方MCP TypeScript SDK
• chalk - 终端样式
• readline - 交互式命令行界面
• zod - 模式验证

许可证

ISC（Internet Service Center，互联网服务中心）

做出贡献

欢迎贡献！请随时提交问题或拉取请求。