Local Development

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

riii111 / ResearchMCP Public

• Notifications
  You must be signed in to change notification settings

• Fork 0

• Star 4

Multi-Search API Aggregator Server built with Deno + Hono

4 stars
0 forks
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

riii111/ResearchMCP

main

1 Branch
0 Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------

History
-------

176 Commits

| | |
| .vscode | | .vscode | Fix: deno-ts error | Mar 14, 2025 |
| docker | | docker | refactor: improved container size | Mar 18, 2025 |
| src | | src | refactor: max result to env variable | Mar 20, 2025 |
| tests | | tests | Update McpController_test.ts | Mar 19, 2025 |
| .dockerignore | | .dockerignore | refactor: improved container size | Mar 18, 2025 |
| .env.example | | .env.example | refactor: max result to env variable | Mar 20, 2025 |
| .gitignore | | .gitignore | chore: delete .deno/ and added ignore | Mar 15, 2025 |
| Makefile | | Makefile | feat. JSON-RPC | Mar 16, 2025 |
| README.md | | README.md | update readme | Mar 27, 2025 |
| cli.ts | | cli.ts | refactor: unified implementation policy | Mar 20, 2025 |
| compose.yml | | compose.yml | Update compose.yml | Mar 20, 2025 |
| deno.json | | deno.json | feat. JSON-RPC | Mar 16, 2025 |
| deno.lock | | deno.lock | Update deno.lock | Mar 20, 2025 |
| main.ts | | main.ts | refactor: use match | Mar 20, 2025 |
| tsconfig.json | | tsconfig.json | chore: deno.ns error | Mar 14, 2025 |
| View all files | | |

Repository files navigation

ResearchMCP

A research tool that combines the Model Context Protocol (MCP) with Brave Search, Tavily Search, etc. to achieve research capabilities equivalent to (or aiming to be equivalent to) ChatGPT's DeepResearch.

Technology Stack

• Runtime: Deno
• Framework: Hono
• Error Handling: Neverthrow (Result pattern)
• Deployment: Docker container

Setup

Local Development

1. Install Deno

2. Clone the repository

3. Set environment variables

   • BRAVE_API_KEY: Brave Search API key
   • TAVILY_API_KEY: Tavily Search API key (optional)
   • Run the application:

   shell make dev # HTTP server make mcp # MCP server for Claude Desktop

Container Environment

1. Install Docker and Docker Compose

2. Set environment variables in a .env file

3. Build and run the container:

   shell make d-build make d-up

Development Commands

# Local development
make dev     # Start HTTP server with watch mode
make mcp     # Start MCP server for Claude Desktop
make test    # Run tests
make lint    # Run linter
make format  # Format code
make check   # Type check

# Docker development
make d-build  # Build the image
make d-dev    # Start container with live reload
make d-up     # Run in background
make d-logs   # View logs
make d-down   # Stop container

MCP Integration with Claude Desktop

1. Run the MCP server: make mcp

2. In Claude Desktop, add a new MCP server with the following configuration:

   json { "mcpServers": { "MCPSearch": { "description": "Web search powered by Brave, Tavily, etc.", "command": "/absolute/path/to/ResearchMCP/cli.ts", "args": [], "transport": "stdio", "env": { "BRAVE_API_KEY": "your_brave_api_key_here", "TAVILY_API_KEY": "your_tavily_api_key_here" } } } }

   Replace /absolute/path/to/ResearchMCP/cli.ts with the actual path to the cli.ts file.

Known Limitations

• Language Support: Brave Search API has limited support for non-Latin characters. Searches in Japanese, Chinese, Korean, and other non-Latin script languages may fail with encoding errors. For best results, use English queries.

Features

• Web Search: Search the web using Brave Search API through Claude Desktop
• MCP Protocol: Full compliance with the Model Context Protocol
• Caching: Search results are cached to improve performance and reduce API calls

About

Multi-Search API Aggregator Server built with Deno + Hono

Topics

hono
deno
mcp-server

Resources

Readme

Activity

Stars

4 stars

Watchers

1 watching

Forks

0 forks

Report repository

Releases

No releases published

Packages 0

No packages published

Languages

• TypeScript 97.6%

• Makefile 2.2%

• Dockerfile 0.2%

You can’t perform that action at this time.