使用说明
MCP快速演示
MCP 快速演示
概述|概述
跨多种编程语言和框架的模型上下文协议（MCP）集成示例的综合集合。此存储库演示了如何使用Go、Python、Java和Node.js中的AI代理连接到Lark MCP服务器并与Feishu文档交互。
一个全面的模型上下文协议 (MCP) 集成示例集合，涵盖多种编程语言和框架。本仓库演示了如何在 Go、Python、Java 和 Node.js 中连接到 Lark MCP 服务器并使用 AI 与飞书/Lark 文档交互。
📁 Project Structure | 项目结构
mcp_quick_demo/
├── go/ # Go implementation | Go 实现
│ ├── main.go
│ ├── app/
│ ├── prompt/
│ └── README.md
├── python/ # Python implementation | Python 实现
│ ├── src/
│ │ ├── mcp-use.py
│ │ ├── langchain-demo.py
│ │ └── prompt.py
│ └── README.md
├── java/ # Java implementation | Java 实现
│ ├── src/
│ ├── pom.xml
│ └── README.md
├── node/ # Node.js implementation | Node.js 实现
│ ├── src/
│ │ ├── ai-sdk.js
│ │ ├── langchain.js
│ │ └── prompt.js
│ └── README.md
└── README.md # This file | 本文件
🚀 Quick Start | 快速开始
Prerequisites | 前置要求
-
Node.js （适用于Lark MCP服务器）| Node.js（用于 Lark MCP 服务器）
node --version # Should be 20+ | 应该是 20+ -
OpenAI API密钥| OpenAI API密钥
-
Lark app credentials | 飞书/Lark 应用凭证
-
Runtime for each language, you can refer to the README.md file in each language directory | 每种语言的运行时环境，详细可以参考各语言的 README.md 文件
Environment Setup | 环境设置
创建 .env 任何项目目录中的文件：
在任何项目目录中创建 .env 文件：
APP_ID=your_lark_app_id
APP_SECRET=your_lark_app_secret
OPENAI_API_KEY=your_openai_api_key
OPENAI_MODEL=gpt-4o
OPENAI_BASE_URL=https://api.openai.com/v1
Choose Your Language and Framework | 选择您的语言和框架
🐹 加油-mcp加油
cd go
go mod tidy
go run .
🐍 Python-mcp使用
cd python
uv sync
uv run src/mcp-use.py
🐍 Python语言链
cd python
uv sync
uv run src/langchain-demo.py
☕ Java-Spring AI
cd java
mvn spring-boot:run
🟨 Node.js-ai sdk
cd nodejs
npm install
npm run dev:ai
🟨 Node.js-语言链
cd nodejs
npm install
npm run dev:langchain
🛠️ How It Works | 工作原理
Architecture Overview | 架构概览
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ AI Application│ │ MCP Client │ │ Lark MCP │
│ │ │ │ │ Server │
│ ┌───────────┐ │ │ ┌───────────┐ │ │ ┌───────────┐ │
│ │ LLM │ │◄──►│ │ MCP │ │◄──►│ │ Feishu │ │
│ │ Model │ │ │ │ Protocol │ │ │ │ Tools │ │
│ └───────────┘ │ │ └───────────┘ │ │ └───────────┘ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
Workflow | 工作流程
-
Initialization | 初始化：连接到Lark MCP服务器 连接到 Lark MCP 服务器
-
Tool Discovery | 工具发现：从MCP服务器检索可用工具 从 MCP 服务器检索可用工具
-
Query Processing | 查询处理：使用工具将用户查询发送到AI模型 将用户查询和工具发送给 AI 模型
-
Tool Execution | 工具执行：根据AI响应执行所需工具 根据 AI 响应执行所需工具
-
Response Generation | 响应生成：将最终响应返回给用户 向用户返回最终响应
🔧 Configuration | 配置
Lark MCP Server | Lark MCP 服务器
所有实现都连接到同一Lark MCP服务器： 所有实现都连接到同一个 Lark MCP 服务器：
npx -y @larksuiteoapi/lark-mcp mcp
🐛 Troubleshooting | 故障排除
Common Issues | 常见问题
-
MCP服务器未启动 | MCP 服务器无法启动
# Check Node.js installation | 检查 Node.js 安装 node --version npm --version # Install Lark MCP manually | 手动安装 Lark MCP npm install -g @larksuiteoapi/lark-mcp -
未加载环境变量 | 环境变量未加载
# Check environment variables | 检查环境变量 echo $OPENAI_API_KEY echo $OPENAI_MODEL # Source environment file | 加载环境文件 source .env
