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

Usage

You can run the server in two ways:

1. Using Command Line Arguments (Recommended)

Replace <app_id> and <app_secret> with your Lark application credentials.

2. Using Environment Variables

Available Tools

get-user-info

Retrieves employee information using their ID.

Example usage in Claude:

Development

1. Clone the repository
2. Install dependencies:
   npm install
3. Build the project:
   npm run build
4. Start the server in development mode:
   npm run dev

Configuration

The server prioritizes credentials in the following order:

1. Command line arguments
2. Environment variables
3. 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

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request