https://github.com/toolhouse-community/mcp-server-toolhouse
https://github.com/toolhouse-community/mcp-server-toolhouse
Last synced: 6 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/toolhouse-community/mcp-server-toolhouse
- Owner: toolhouse-community
- License: mit
- Created: 2024-12-16T05:00:49.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-05T04:56:51.000Z (7 months ago)
- Last Synced: 2025-04-14T01:54:43.004Z (6 months ago)
- Language: Python
- Size: 72.3 KB
- Stars: 8
- Watchers: 1
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- mcp-index - Toolhouse MCP Server - Connects MCP clients with Toolhouse's tools through a unified API for efficient inference and interaction with external data sources. (Business Tools)
README
# Toolhouse MCP Server
This MCP server allows you to connect MCP clients with Toolhouse's tools. Built on top of [Toolhouse](https://toolhouse.ai/) and Groq's API - for fast inference.
[The Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you’re building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.
## Features
- Allows compatible MCP Clients (i.e Claude Desktop App) to access a vast library of tools to enhance their capabilities
## Configuration
### Setup Environment Variables
1. **Toolhouse API Key**:
You need a Toolhouse API Key to access the Toolhouse platform.
- Sign up at [Toolhouse](https://toolhouse.ai/) and create an account, it's FREE to get started.
- Obtain your API key from the Toolhouse dashboard.
2. **Toolhouse Bundle**:
You need to create a bundle, essentially a group of tools you can assemble from the ones available on the Toolhouse platform.
- Navigate to [Toolhouse Bundles]() and create a bundle with any name i.e. `mcp-toolhouse`
- Add the tools that you want to use on your client i.e. Scrape the web, Memory, Send Email
- Ensure your bundle looks good (it auto saves)
3. (Optional) Set these environment variables if you prefer not having them in the configuration:
```bash
export TOOLHOUSE_API_KEY="your_toolhouse_api_key"
export TOOLHOUSE_BUNDLE="your_bundle_name"
```
### Starting the server
> [!TIP]
> If you are stuck configuring your client, i.e. Cursor, Windsurf, Cline etc... open an Issue here on Github and I will help you personally.
Add this server to your client's configuration.
For example on Claude's desktop app navigate to the folder and manually change the settings file called `claude_desktop_config.json`
On MacOS:
```bash
~/Library/Application\ Support/Claude/claude_desktop_config.json
```
On Windows:
```bash
%APPDATA%/Claude/claude_desktop_config.json
```
Modify the configuration file to look like this:
## With UVX
```json
{
"mcpServers": {
"mcp-server-toolhouse": {
"command": "uvx",
"args": ["mcp_server_toolhouse"],
"env": {
"TOOLHOUSE_API_KEY": "your_toolhouse_api_key",
"TOOLHOUSE_BUNDLE": "a_bundle_name"
}
}
}
}
```
## With UV
```json
{
"mcpServers": {
"mcp-server-toolhouse": {
"command": "uv",
"args": [
"--directory",
"/path/to/this/folder/mcp-server-toolhouse",
"run",
"mcp_server_toolhouse"
],
"env": {
"TOOLHOUSE_API_KEY": "your_toolhouse_api_key",
"TOOLHOUSE_BUNDLE": "a_bundle_name"
}
}
}
}
```
### Run this project locally
This project is not yet configured for ephemeral environments like `uvx`. Run the project locally by cloning the repository:
```bash
git clone https://github.com/toolhouse-community/mcp-server-toolhouse.git
```
Add this tool as an MCP server.
On MacOS:
```bash
~/Library/Application\ Support/Claude/claude_desktop_config.json
```
On Windows:
```bash
%APPDATA%/Claude/claude_desktop_config.json
```
Modify the configuration file to include:
```json
"toolhouse": {
"command": "uv",
"args": [
"--directory",
"/path/to/this/repo/",
"run",
"mcp-server-toolhouse"
],
"env": {
"TOOLHOUSE_API_KEY": "your_toolhouse_api_key",
"TOOLHOUSE_BUNDLE": "a_bundle_name"
}
}
```
## TODO
Future improvements include:
- Adding test coverage for all modules
- Extending API support for enhanced tool configurations
## Debugging
Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, use the [MCP Inspector](https://github.com/modelcontextprotocol/inspector).
Launch the Inspector via [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm):
```bash
npx @modelcontextprotocol/inspector uv --directory /path/to/toolhouse_mcp run toolhouse-mcp
```
The Inspector will display a URL to access debugging tools in your browser.