
MCP Starter Project

2025.04.05
0
JavaScriptAI 应用开发文档搜索对话系统开发效率
MCP Starter Project 是一个基于 Model Context Protocol (MCP) 标准的 AI 应用开发项目,旨在帮助开发者构建能够与外部工具和 API 交互的 AI 应用程序。该项目包含 MCP Server(Python 服务)和 MCP Client(TypeScript/JavaScript 客户端)两个主要组件,支持文档搜索、对话管理、工具集成等功能。
View on GitHub
Overview
基本能力
产品定位
MCP Starter Project 是一个用于构建 AI 应用程序的开发框架,支持与外部工具和 API 的交互。
核心功能
- 文档搜索工具:支持搜索 LangChain、LlamaIndex、OpenAI 等流行 AI 库的文档。
- 对话管理:维护每个会话的聊天历史。
- 工具集成:无缝集成 AI 模型响应与工具调用。
- 错误处理:对 API 调用和工具执行进行健壮的错误处理。
适用场景
- AI 应用开发:快速构建能够调用外部工具的 AI 应用。
- 文档搜索:为 AI 模型提供实时文档搜索能力。
- 对话系统:开发支持多轮对话的 AI 聊天系统。
工具列表
- 文档搜索工具:用于搜索 LangChain、LlamaIndex、OpenAI 等库的文档。
- 对话管理工具:维护和管理会话历史。
常见问题解答
- 如何获取 API 密钥:需要 Hugging Face API 密钥和 Serper API 密钥。
- 如何启动服务:分别启动 MCP Server 和 MCP Client。
使用教程
使用依赖
- Python 3.11 或更高版本
- Node.js 18 或更高版本
- Hugging Face API 密钥
- Serper API 密钥
安装教程
- 设置 MCP Server
cd mcp-server
python -m venv .venv
.venv\Scripts\activate
pip install -e .
- 设置 MCP Client
cd mcp-clients
npm install
npm run build
调试方式
- 启动 MCP Server
cd mcp-server
python main.py
- 启动 MCP Client
cd mcp-clients
node build/index.js ../mcp-server/main.py
- 测试 API
- 健康检查:
GET http://localhost:3000/health
- 聊天:
POST http://localhost:3000/chat