Lark MCP Server
A Model Context Protocol (MCP) server that integrates with Lark/Feishu APIs, allowing LLMs to interact with Lark services.
Features
- Query employee information using Lark's Contact API
- More features coming soon...
Prerequisites
- Node.js 16 or higher
- A Lark/Feishu application with App ID and App Secret
- Claude for Desktop or another MCP client
Installation
npm install
npm run build
Usage
You can run the server in two ways:
1. Using Command Line Arguments (Recommended)
npx lark-mcp <app_id> <app_secret>
Replace <app_id> and <app_secret> with your Lark application credentials.
2. Using Environment Variables
export LARK_APP_ID=your_app_id
export LARK_APP_SECRET=your_app_secret
npx lark-mcp
Available Tools
get-user-info
Retrieves employee information using their ID.
Example usage in Claude:
Please look up employee information for ID 12345
Development
- Clone the repository
- Install dependencies:
npm install
- Build the project:
npm run build
- Start the server in development mode:
npm run dev
Configuration
The server prioritizes credentials in the following order:
- Command line arguments
- Environment variables
- Default values (if any)
Error Handling
- The server will validate credentials before starting
- API errors are properly handled and returned to the client
- Detailed error messages help with troubleshooting
License
MIT
Contributing
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Create a new Pull Request
