
MCP-Server 项目文档

2025.03.28
1
TypeScriptLLM增强工具调用过程可视化开发效率
MCP-Server 是一个基于 Model Context Protocol (MCP) 的服务端和客户端实现,旨在通过结构化协议让大语言模型(LLM)能够调用外部工具完成复杂任务。该项目包含服务端和TypeScript客户端两部分,支持工具注册与执行、与大语言模型通信、白盒过程可视化等功能,适用于需要增强LLM能力的开发场景。
View on GitHub
Overview
基本能力
产品定位
MCP-Server 是一个用于扩展大语言模型能力的中间件服务,通过结构化协议实现LLM与外部工具的交互。
核心功能
- MCP 服务端
- 工具注册与执行(如天气预报、GitHub用户信息查询)
-
通过标准输入输出(stdio)与客户端通信
-
MCP 客户端
- 连接大语言模型API(默认Deepseek)
- 解析工具调用请求并协调流程
-
提供命令行交互界面和Express Web API
-
Web API
-
/sse
端点处理前端查询请求,支持流式响应 -
白盒过程可视化
- 展示意图识别、工具选择、调用参数及结果等过程
适用场景
- 需要LLM调用外部API的应用程序
- 开发增强型AI助手
- 构建可视化LLM工作流的项目
工具列表
- 天气预报查询工具:通过高德地图API获取天气数据
- GitHub用户信息查询工具:获取GitHub用户基本信息
常见问题
- 需要配置
.env
文件中的API密钥(Deepseek和高德地图) - 通信依赖标准输入输出(stdio)
使用教程
使用依赖
- 安装Node.js环境
- 准备API密钥:
- Deepseek API密钥
- 高德地图API密钥
安装教程
- 启动服务端:
node dist/src/index.js
- 启动客户端:
node dist/mcp-client-typescript/src/index.js /path/to/server/script.js
调试方式
- 测试Web API:
curl -X POST http://localhost:3000/sse \
-H "Content-Type: application/json" \
-d '{"query": "北京今天的天气怎么样?"}'
- 检查环境变量配置
- 查看命令行交互输出
许可证
None