模型上下文协议服务器与客户端

一个基于TypeScript的模型上下文协议(MCP)服务器和客户端实现,用于资源管理、用户操作及与Google生成式AI(Gemini)的交互。

  • by Sagnik-23
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 sagnik-23/mcp_server

使用说明

MCP服务器和客户端

这个项目是TypeScript中的模型上下文协议(MCP)服务器和客户端实现。它允许您运行MCP服务器,使用客户端与之交互,并管理资源和工具,如用户创建和查询。

特性

  • 具有资源和工具定义的MCP服务器
  • 用户管理(创建、列表等)
  • 带有工具、资源和查询提示的交互式客户端
  • 与谷歌生成式人工智能(Gemini)集成
  • 基于TypeScript的代码库

入门指南

先决条件

  • Node.js(建议使用v18+)
  • npm

安装

  1. 克隆存储库:
    git clone <repo-url>
    cd MCP_Server
    
  2. 安装依赖项:
    npm install
    

构建

要将TypeScript编译为JavaScript:

npm run server:build

运行服务器

要启动MCP服务器,请执行以下操作:

npm run server:dev

运行客户端

要启动交互式客户端,请执行以下操作:

npm run server:dev

用法

  • 客户端将提示您选择操作:查询、工具、资源、提示或退出。
  • 对于工具(例如用户创建),请按照提示输入必填字段。
  • 对于资源,选择并提供任何所需的参数。
  • 对于提示,与人工智能驱动的文本生成进行交互。

项目结构

MCP_Server/
├── src/
│   ├── server.ts      # MCP server implementation
│   ├── client.ts      # Interactive client
│   └── data/
│       └── users.json # User data storage
├── build/             # Compiled JS output
├── package.json       # Project configuration
├── tsconfig.json      # TypeScript configuration
└── README.md          # Project documentation

环境变量

  • 要使用Google Generative AI,请在 .env 文件:
    GEMINI_API_KEY=your-google-api-key
    

许可证

国际协调委员会

作者

萨格尼克-23