Provides secure authentication for APIs through 1Password secret references, allowing the retrieval of credentials stored in 1Password vaults.
emcee
emcee is a tool that provides a server for any web application with an specification. You can use emcee to connect and to external tools and data services, similar to .
Quickstart
If you're on macOS and have installed, you can get up-and-running quickly.
Make sure you have Claude Desktop installed.
To configure Claude Desktop for use with emcee:
Open Claude Desktop Settings (⌘,)
Select the "Developer" section in the sidebar
Click "Edit Config" to open the configuration file
The configuration file should be located in the Application Support directory. You can also open it directly in VSCode using:
Add the following configuration to add the weather.gov MCP server:
After saving the file, quit and re-open Claude. You should now see 🔨57 in the bottom right corner of your chat box. Click on that to see a list of all the tools made available to Claude through MCP.
Start a new chat and ask it about the weather where you are.
What's the weather in Portland, OR?
Claude will consult the tools made available to it through MCP and request to use one if deemed to be suitable for answering your question. You can review this request and either approve or deny it.
If you allow, Claude will communicate with the MCP and use the result to inform its response.
Building agents? Want to deploy remote MCP servers? Reach out to us atemcee@loopwork.com
Why use emcee?
MCP provides a standardized way to connect AI models to tools and data sources. It's still early days, but there are already a variety of for connecting to browsers, developer tools, and other systems.
We think emcee is a convenient way to connect to services that don't have an existing MCP server implementation — especially for services you're building yourself. Got a web app with an OpenAPI spec? You might be surprised how far you can get without a dashboard or client library.
Installation
Installer Script
Use the to download and install a of emcee for your platform (Linux x86-64/i386/arm64 and macOS Intel/Apple Silicon).
Homebrew
Install emcee using from .
Docker
Prebuilt with emcee are available.
Build From Source
Requires or later.
Once built, you can run in place (./emcee
)
or move it somewhere in your PATH
, like /usr/local/bin
.
Usage
emcee implements Standard Input/Output (stdio) transport for MCP, which uses JSON-RPC 2.0 as its wire format.
When you run emcee from the command-line, it starts a program that listens on stdin, outputs to stdout, and logs to stderr.
Authentication
For APIs that require authentication, emcee supports several authentication methods:
Authentication Type | Example Usage | Resulting Header |
Bearer Token |
|
|
Basic Auth |
|
|
Raw Value |
|
|
These authentication values can be provided directly or as .
When using 1Password references:
Use the format
op://vault/item/field
(e.g.--bearer-auth="op://Shared/X/credential"
)Ensure the 1Password CLI () is installed and available in your
PATH
Sign in to 1Password before running emcee or launching Claude Desktop
emcee doesn't use auth credentials when downloading
OpenAPI specifications from URLs provided as command arguments.
If your OpenAPI specification requires authentication to access,
first download it to a local file using your preferred HTTP client,
then provide the local file path to emcee.
Transforming OpenAPI Specifications
You can transform OpenAPI specifications before passing them to emcee using standard Unix utilities. This is useful for:
Selecting specific endpoints to expose as tools with or
Modifying descriptions or parameters with
Combining multiple specifications with
For example,
you can use jq
to include only the point
tool from weather.gov
.
JSON-RPC
You can interact directly with the provided MCP server by sending JSON-RPC requests.
emcee provides only MCP tool capabilities. Other features like resources, prompts, and sampling aren't yet supported.
List Tools
Call Tool
Debugging
The is a tool for testing and debugging MCP servers. If Claude and/or emcee aren't working as expected, the inspector can help you understand what's happening.
License
emcee is licensed under the Apache License, Version 2.0.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Generate an MCP server for any OpenAPI documented endpoint.
Related MCP Servers
- -securityAlicense-qualityAn MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.Last updated -8MIT License
- AsecurityAlicenseAqualityA TypeScript-based MCP server that generates API clients from OpenAPI specifications, allowing automated code generation through natural language.Last updated -11381MIT License
- -securityAlicense-qualityA framework to use with AI to easily create a server for any service. Just drop the API Documentation in it and ask to create the MCP.Last updated -5MIT License
- -securityFlicense-qualityAn auto-generated MCP server that enables interaction with the OpenAI API, allowing users to access OpenAI's models and capabilities through the Multi-Agent Conversation Protocol.Last updated -