MCP Starter Project

MCP Starter Project

site icon
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 的交互。

核心功能

  1. 文档搜索工具:支持搜索 LangChain、LlamaIndex、OpenAI 等流行 AI 库的文档。
  2. 对话管理:维护每个会话的聊天历史。
  3. 工具集成:无缝集成 AI 模型响应与工具调用。
  4. 错误处理:对 API 调用和工具执行进行健壮的错误处理。

适用场景

  1. AI 应用开发:快速构建能够调用外部工具的 AI 应用。
  2. 文档搜索:为 AI 模型提供实时文档搜索能力。
  3. 对话系统:开发支持多轮对话的 AI 聊天系统。

工具列表

  1. 文档搜索工具:用于搜索 LangChain、LlamaIndex、OpenAI 等库的文档。
  2. 对话管理工具:维护和管理会话历史。

常见问题解答

  1. 如何获取 API 密钥:需要 Hugging Face API 密钥和 Serper API 密钥。
  2. 如何启动服务:分别启动 MCP Server 和 MCP Client。

使用教程

使用依赖

  1. Python 3.11 或更高版本
  2. Node.js 18 或更高版本
  3. Hugging Face API 密钥
  4. Serper API 密钥

安装教程

  1. 设置 MCP Server
cd mcp-server
python -m venv .venv
.venv\Scripts\activate
pip install -e .
  1. 设置 MCP Client
cd mcp-clients
npm install
npm run build

调试方式

  1. 启动 MCP Server
cd mcp-server
python main.py
  1. 启动 MCP Client
cd mcp-clients
node build/index.js ../mcp-server/main.py
  1. 测试 API
  2. 健康检查:GET http://localhost:3000/health
  3. 聊天:POST http://localhost:3000/chat

许可证

该项目遵循 MIT 开源许可条款。