AI MCP Agent

MCPAI代理

提供方 ixlander

AI代理 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

一个集成MCP协议的企业级AI代理,提供自然语言查询处理、产品数据管理和REST API集成功能。

一句话选型结论

按资料字段整理

AI MCP Agent 属于AI代理类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 6 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量6暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

AI代理Python本地部署产品管理自然语言处理企业级架构RESTAPI

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python -m venv venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 6 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 6 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
AI MCP Agent当前 6 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ixlander上游标注的维护方 ixlander
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.2 KB
来自项目仓库与上游目录的原文,未做删改

“#AI MCP代理

> 具有MCP集成的AI Agent-面向企业的产品管理架构

📋 项目描述

集成MCP(Model Context Protocol)的全功能AI代理:

  • 使用Langgraph定制工具
  • 连接到MCP服务器以管理产品数据
  • 处理用户的自然语言查询
  • 为集成提供REST API
  • 通过Docker Compose启动

🏗️ 建筑```

┌─────────────────────────────────────────────────────────┐
│ Docker Container │
│ ┌───────────────────────────────────────────────────┐ │
│ │ FastAPI Application │ │
│ │ POST /api/v1/agent/query │ │
│ │ (Получает запросы пользователя) │ │
│ └─────────────────────┬─────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ LangGraph Agent │ │
│ │ • Анализирует запрос пользователя │ │
│ │ • Выбирает подходящие tools │ │
│ │ • Вызывает tools и обрабатывает результаты │ │
│ │ • Формирует ответ │ │
│ └───┬──────────────────────────────┬────────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────────────────┐ │
│ │ Custom Tools │ │ MCP Server │ │
│ │ │ │ (stdio transport) │ │
│ │ • Calculator │ │ │ │
│ │ • Formatter │ │ Tools: │ │
│ └──────────────┘ │ • list_products │ │
│ │ • get_product │ │
│ │ • add_product │ │
│ │ • get_statistics │ │
│ │ │ │
│ │ Storage: │ │
│ │ • JSON file │ │
│ └──────────────────────────┘ │
└─────────────────────────────────────────────────────────┘


## 🚀 快速启动

### 选项1:Docker Compose(推荐)

**要求:**

- Docker引擎20.10+
- Docker Compose 2.0+

**启动:**```bash
# 1. Клонируйте репозиторий (если нужно)
git clone
cd ai-mcp-agent

# 2. Запустите приложение
docker-compose up -d

# 3. Проверьте статус
docker-compose ps

# 4. Откройте API документацию
# http://localhost:8000/docs

停止:```bash
docker-compose down


### 选项2:本地(无Docker)

**要求:**

- Python 3.11+
- pipили诗歌

**依赖关系设置:**```bash
# Создайте виртуальное окружение
python -m venv venv

# Активируйте его
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

# Установите зависимости
pip install -r requirements.txt

启动MCP服务器:```bash

В отдельном терминале

python -m mcp_server.mcp_server


**启动Fastapi应用程序:**```bash
# В основном терминале
python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

API文档:

  • Swagger用户界面:http://localhost:8000/docs
  • 重新记录:http://localhost:8000/redoc

📡 API终点

健康检查```http

GET /health


**答复:**```json
{
"status": "healthy",
"message": "API is running"
}

查询代理```http

POST /api/v1/agent/query
Content-Type: application/json

{
"query": "Покажи все продукты в категории Электроника"
}


**答复:**```json
{
"query": "Покажи все продукты в категории Электроника",
"response": "Products in Электроника: {...}",
"status": "success"
}

例子```http

GET /api/v1/examples


**答复:**```json
{
"examples": [
{
"query": "Покажи все продукты",
"description": "Get all products"
},
...
]
}

💬 使用示例

例1:获取所有产品```bash

curl -X POST http://localhost:8000/api/v1/agent/query \
-H "Content-Type: application/json" \
-d '{"query": "Покажи все продукты"}'


### 例2:按类别获取产品```bash
curl -X POST http://localhost:8000/api/v1/agent/query \
-H "Content-Type: application/json" \
-d '{"query": "Покажи все продукты в категории Электроника"}'

例3:获取统计数据```bash

curl -X POST http://localhost:8000/api/v1/agent/query \
-H "Content-Type: application/json" \
-d '{"query": "Какая средняя цена продуктов?"}'


### 例4:计算折扣```bash
curl -X POST http://localhost:8000/api/v1/agent/query \
-H "Content-Type: application/json" \
-d '{"query": "Посчитай скидку 15% на товар с ID 1"}'

例5:通过ID查找产品```bash

curl -X POST http://localhost:8000/api/v1/agent/query \
-H "Content-Type: application/json" \
-d '{"query": "Найди товар с ID 1"}'


## 🧪 测试

### 运行测试```bash
# Запустите все тесты
pytest tests/ -v

# Запустите с покрытием
pytest tests/ --cov=app --cov=mcp_server

# Запустите конкретный тест
pytest tests/test_api.py::TestHealthEndpoint::test_health_check -v

可用测试

test_agent.py:

  • TestCalculatorTool -计算器测试(3个测试)
  • TestFormatterTool -格式化测试(4个测试)
  • TestAgentProcessing -查询处理测试(4个测试)
  • TestAgentIntegration 集成测试(3个测试)

test_api.py:

  • TestHealthEndpoint 健康检查(2个测试)
  • TestQueryEndpoint Query Endpoint(6个测试)
  • TestExamplesEndpoint Examples Endpoint(2个测试)
  • TestErrorHandling 错误处理测试(2个测试)
  • TestEndpoints 一般Endpoints测试(1个测试)

共计:27+测试

测试结果示例```

tests/test_agent.py::TestCalculatorTool::test_percentage_calculation PASSED
tests/test_agent.py::TestCalculatorTool::test_simple_arithmetic PASSED
tests/test_agent.py::TestFormatterTool::test_json_formatting PASSED
tests/test_api.py::TestHealthEndpoint::test_health_check PASSED
tests/test_api.py::TestQueryEndpoint::test_query_endpoint_basic PASSED
...


## 📦 项目结构```
ai-mcp-agent/
├── app/                          # FastAPI приложение
│   ├── __init__.py
│   ├── main.py                  # FastAPI endpoints
│   └── agent.py                 # LangGraph агент
├── mcp_server/                   # MCP сервер
│   ├── __init__.py
│   └── mcp_server.py            # MCP сервер с FastMCP
├── tests/                        # Тесты
│   ├── __init__.py
│   ├── test_agent.py            # Тесты агента
│   └── test_api.py              # Тесты API
├── data/                         # Данные
│   └── products.json            # Данные о продуктах
├── .gitignore                    # Git ignore файл
├── requirements.txt              # Python зависимости
├── Dockerfile                    # Docker конфигурация
├── docker-compose.yml            # Docker Compose конфигурация
└── README.md                     # Этот файл

🔧 系统组件

MCP服务器(mcp_server/mcp_server.py)

使用: FastMCP,JSON存储

工具(Tools):

  1. list_products -获取产品列表(可选类别)
  2. get_product 通过ID获取产品
  3. add_product -添加新产品
  4. get_statistics -获取产品统计数据

特点:

  • ✅ 通过STDIO运输工作
  • ✅ Type Hints适用于所有参数
  • ✅ 描述
  • ✅ 错误处理(valueerror)
  • ✅ JSON数据序列化

LangGraph代理(app/agent.py)

使用: LangGraph,LangChain,模拟法学硕士

自定义工具:

  1. calculator -表达式和折扣的计算
  2. formatter 文本格式化(JSON,Uppercase,Lowercase)

特点:

  • ✅ 与MCP服务器集成
  • ✅ 自然语言处理
  • ✅ 路由请求到正确的工具
  • ✅ Mock LLM没有真正的API密钥

FastAPI应用程序(app/main.py)

终点:

  1. GET /health -健康检查
  2. POST /api/v1/agent/query -请求代理
  3. GET /api/v1/examples 查询示例

特点:

  • ✅ Pydantic型号的安全型
  • ✅ CORS支持
  • ✅ 记录
  • ✅ 错误处理
  • ✅ swagger/redoc文档

🐳 码头工人

DockerFile功能

  • 多阶段构建 -优化图像大小
  • 健康检查 -自动集装箱健康检查
  • 薄型基础图像 -最小大小(从120MB开始)

Docker Compose服务

  1. 应用程序编程接口 -端口8000上的Fastapi应用程序
  2. mcp服务器 端口 3001 上的 MCP 服务器

体积:

  • ./data -持久数据
  • ./app -应用程序代码
  • ./mcp_server -服务器MCP代码

📊 支持的查询类型

类型,例子,结果。
产品列表–“显示所有产品”–完整列表。
ÐÐÐÐÐÐÐÐÐÐÐÐÐ
“平均价格是多少?”统计。
–ID–“查找ID 1的产品”–特定产品–。
“计算15%的折扣”–计算结果→

🔐 安全

实施的措施:

  • ✅ 类型验证сPydantic
  • ✅ 错误处理和日志记录
  • ✅ CORS保护
  • ✅ 添加数据时的验证

关于Production的建议:

  • 添加身份验证(JWT,OAuth2)
  • 使用HTTPS
  • 添加速度限制
  • 配置防火墙规则

🛠️ 开发

添加新工具

在MCP服务器上:```python
@server.tool()
def my_tool(param: str) -> dict:
"""Tool description."""
return {"result": "value"}


**在代理:**```python
@tool
def my_custom_tool(param: str) -> str:
"""Custom tool description."""
return f"Result: {param}"

添加新的Endpoint```python

@app.post("/api/v1/my-endpoint")
async def my_endpoint(request: MyRequest) -> MyResponse:
"""Endpoint description."""

Implementation

return response


## 🐛 故障排除

### Проблема:端口已在使用中```bash
# Освободите порт
# Windows:
netstat -ano | findstr :8000
taskkill /PID  /F

# Linux/Mac:
lsof -i :8000
kill -9

问题: ModuleNotFoundError```bash

Убедитесь что виртуальное окружение активировано

Windows:

venv\Scripts\activate

Linux/Mac:

source venv/bin/activate

Переустановите зависимости

pip install -r requirements.txt


### 问题:Docker映像不可用```bash
# Очистите Docker кэш
docker-compose down -v
docker system prune -a

# Пересоберите
docker-compose build --no-cache

📚 追加资源

  • FastMCP文档
  • LangGraph文档
  • FastAPI文档
  • Docker文档

📄 许可证

MIT许可证-免费用于教育目的


版本: 1.0.0"

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
AI MCP Agent 怎么安装?

在客户端按下面的安装命令接入:python -m venv venv。装完在客户端配置里引用同一个包或端点。

AI MCP Agent 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

AI MCP Agent 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

AI MCP Agent 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

AI MCP Agent 能提供哪些能力?

资料显示约 6 个工具;能力标签包括 AI代理、产品管理、Python、自然语言处理。具体工具清单以官方文档为准。

AI MCP Agent 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

AI MCP Agent 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。