🌐 MCP para todo – Servidor modular con herramientas útiles

🌐 MCP para Todo - 大语言模型工具服务

教育用途的 MCP（Model Context Protocol）服务，可将 ChatGPT 等大语言模型与实时外部工具连接。使用 TypeScript 开发，采用可扩展的模块化架构。

📖 什么是 MCP？

Model Context Protocol（MCP） 是一项新兴标准，允许大语言模型以安全、结构化的方式与外部工具、API 和系统进行交互。

💡 项目价值

• 连接 AI 与现实世界： 搭建大语言模型与外部功能之间的桥梁
• 模块化架构： 可轻松扩展新工具
• 标准协议： 兼容任何 MCP 客户端

🛠️ 已实现的工具

工具	描述	输入	示例
get_weather	按城市查询当前天气	{ "city": "Bogotá" }	温度、湿度、天气状况
word_definition	释义和同义词	{ "word": "innovación" }	含义、示例、同义词
evaluate_math	计算表达式	{ "expression": "2^8 + sqrt(81)" }	数值结果

技术栈

• 语言： TypeScript 5.0+
• 运行时： Node.js 18+
• 协议： MCP（Model Context Protocol）
• 外部 API： OpenWeather、DictionaryAPI

⚡ 安装和使用

前置条件

node --version  # ≥ 18.0.0
npm --version   # ≥ 9.0.0

1. 克隆仓库

git clone https://github.com/elsantiwg/MCP-para-todo.git
cd MCP-para-todo

2. 安装依赖项

npm install

3. 配置环境变量

cp .env.example .env

使用你的 API 密钥编辑 .env

4. 在开发模式下运行

npm run dev

.env 配置

OPENWEATHER_API_KEY=tu_api_key_aca
DICTIONARY_API_URL=https://api.dictionaryapi.dev/api/v2

🔌 与 MCP 客户端集成

连接示例

// Cliente MCP se conecta al servidor
const client = new MCPClient('ws://localhost:3000');

// 从模型调用工具

const weather = await client.callTool('get_weather', { city: 'Madrid' });
const calculation = await client.callTool('evaluate_math', { expression: 'sin(π/2)' });

🧩 扩展系统

创建新工具

// src/tools/nueva-herramienta.ts
export const nuevaHerramienta: ToolHandler = {
  name: "mi_herramienta",
  description: "Descripción de la funcionalidad",
  inputSchema: {
    type: "object",
    properties: {
      parametro: { type: "string" }
    }
  },
  handler: async ({ parametro }) => {
    // Lógica de la herramienta
    return { resultado: "éxito" };
  }
};

在服务中注册

// En src/tools/index.ts
export const tools = [
  weatherTool,
  dictionaryTool, 
  mathTool,
  nuevaHerramienta  // ← Nueva herramienta agregada
];

🚀 使用场景

智能助手

具备实际能力的对话式 Agent

可实时访问数据的客户服务机器人

具备现实世界上下文的个人助手

自动化 具备计算能力的数据处理

与企业系统集成

具备 AI 推理能力的自动化工作流

📊 路线图

更多工具：翻译、新闻、货币换算

身份验证：为敏感工具提供安全系统

监控：使用情况和指标仪表板

部署：Docker 容器和云配置

👨‍💻 作者 Kevin Santiago Prieto Guerrero

GitHub：@elsantiwg

LinkedIn：Kevin Prieto

作品集：https://elsantiwg.trendio.com.co

📄 许可证 本项目采用 MIT 许可证。详情请参阅 LICENSE。