MCP-Server 项目文档

MCP-Server 项目文档

site icon
2025.03.28 1
TypeScriptLLM增强工具调用过程可视化开发效率
MCP-Server 是一个基于 Model Context Protocol (MCP) 的服务端和客户端实现,旨在通过结构化协议让大语言模型(LLM)能够调用外部工具完成复杂任务。该项目包含服务端和TypeScript客户端两部分,支持工具注册与执行、与大语言模型通信、白盒过程可视化等功能,适用于需要增强LLM能力的开发场景。
View on GitHub

Overview

基本能力

产品定位

MCP-Server 是一个用于扩展大语言模型能力的中间件服务,通过结构化协议实现LLM与外部工具的交互。

核心功能

  1. MCP 服务端
  2. 工具注册与执行(如天气预报、GitHub用户信息查询)
  3. 通过标准输入输出(stdio)与客户端通信

  4. MCP 客户端

  5. 连接大语言模型API(默认Deepseek)
  6. 解析工具调用请求并协调流程
  7. 提供命令行交互界面和Express Web API

  8. Web API

  9. /sse端点处理前端查询请求,支持流式响应

  10. 白盒过程可视化

  11. 展示意图识别、工具选择、调用参数及结果等过程

适用场景

  • 需要LLM调用外部API的应用程序
  • 开发增强型AI助手
  • 构建可视化LLM工作流的项目

工具列表

  1. 天气预报查询工具:通过高德地图API获取天气数据
  2. GitHub用户信息查询工具:获取GitHub用户基本信息

常见问题

  • 需要配置.env文件中的API密钥(Deepseek和高德地图)
  • 通信依赖标准输入输出(stdio)

使用教程

使用依赖

  1. 安装Node.js环境
  2. 准备API密钥:
  3. Deepseek API密钥
  4. 高德地图API密钥

安装教程

  1. 启动服务端:
node dist/src/index.js
  1. 启动客户端:
node dist/mcp-client-typescript/src/index.js /path/to/server/script.js

调试方式

  1. 测试Web API:
curl -X POST http://localhost:3000/sse \
-H "Content-Type: application/json" \
-d '{"query": "北京今天的天气怎么样?"}'
  1. 检查环境变量配置
  2. 查看命令行交互输出

许可证

None