lark MCP quick demo

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 | 前置要求

1. Node.js （适用于Lark MCP服务器）| Node.js（用于 Lark MCP 服务器）

   node --version  # Should be 20+ | 应该是 20+

1. OpenAI API密钥| OpenAI API密钥

1. Lark app credentials | 飞书/Lark 应用凭证

1. 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 | 工作流程

1. Initialization | 初始化：连接到Lark MCP服务器

连接到 Lark MCP 服务器

1. Tool Discovery | 工具发现：从MCP服务器检索可用工具

从 MCP 服务器检索可用工具

1. Query Processing | 查询处理：使用工具将用户查询发送到AI模型

将用户查询和工具发送给 AI 模型

1. Tool Execution | 工具执行：根据AI响应执行所需工具

根据 AI 响应执行所需工具

1. Response Generation | 响应生成：将最终响应返回给用户

向用户返回最终响应

🔧 Configuration | 配置

Lark MCP Server | Lark MCP 服务器

所有实现都连接到同一Lark MCP服务器： 所有实现都连接到同一个 Lark MCP 服务器：

npx -y @larksuiteoapi/lark-mcp mcp

🐛 Troubleshooting | 故障排除

Common Issues | 常见问题

1. MCP服务器未启动 | MCP 服务器无法启动

   # Check Node.js installation | 检查 Node.js 安装
   node --version
   npm --version

   # Install Lark MCP manually | 手动安装 Lark MCP
   npm install -g @larksuiteoapi/lark-mcp

1. 未加载环境变量 | 环境变量未加载

   # Check environment variables | 检查环境变量
   echo $OPENAI_API_KEY
   echo $OPENAI_MODEL

   # Source environment file | 加载环境文件
   source .env

📚 Resources | 资源

Documentation | 文档

• 模型上下文协议
• 飞树开放平台
• Lark开发人员
• Lark OpenAPI MCP
• LangChain MCP适配器
• LangChain
• MCP使用
• OpenAI API文档