Mcpforge Dfc08e46

MCP开发工具

提供方 Richardmsbr

开发工具 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude
查看接入方式

MCPForge是一个提供经过实战检验的架构模式和生产就绪模板的框架,用于构建跨多种语言的MCP(模型上下文协议)服务器。

一句话选型结论

按资料字段整理

Mcpforge Dfc08e46 属于开发工具类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

架构模式TypeScript本地部署MCP服务器多语言支持CLI工具生产就绪

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
pip install -e .

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Mcpforge Dfc08e46当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Richardmsbr上游标注的维护方 Richardmsbr
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.0 KB
来自项目仓库与上游目录的原文,未做删改

MCPForge

The Architecture Patterns Framework for Model Context Protocol


MCPForge is a framework providing documented architecture patterns, ready-to-use templates, and a CLI for building MCP (Model Context Protocol) servers across multiple languages.

Stop reinventing the wheel. Start forging production-ready MCP servers.


Why MCPForge?

The MCP ecosystem is growing fast, but developers face the same challenges repeatedly:

Problem MCPForge Solution
No standardized patterns 12+ documented design patterns with implementations
Language-specific knowledge Unified templates for Python, TypeScript, Go, Rust
Boilerplate overhead CLI generates production-ready scaffolds in seconds
Security gaps Built-in OAuth 2.1, rate limiting, and hardening guides
Scaling uncertainty Enterprise patterns for microservices and gateways

Features

Design Patterns Library

Pre-built, documented patterns for every MCP use case:```
Structural Patterns Behavioral Patterns Enterprise Patterns
------------------- ------------------- -------------------
- Adapter - Command - API Gateway
- Facade - Strategy - Service Mesh
- Proxy - Observer - Circuit Breaker
- Decorator - Chain of Responsibility - Bulkhead


Production-ready templates with consistent architecture:```
templates/
  python/
    basic/           # Single-purpose MCP server
    enterprise/      # Auth, logging, monitoring
    microservices/   # Distributed MCP architecture
  typescript/
    basic/
    enterprise/
    microservices/
  go/
    basic/
    enterprise/
  rust/
    basic/
    enterprise/

Powerful CLI```bash

Install globally

npm install -g mcpforge

Create a new MCP server

mcpforge new my-server --lang python --pattern adapter

Add a tool to existing server

mcpforge add tool search --server my-server

Generate architecture diagram

mcpforge diagram my-server --output svg

Validate server structure

mcpforge validate my-server


---

## Quick Start

### 1. Install the CLI```bash
npm install -g mcpforge

2. Create Your First Server```bash

mcpforge new my-first-mcp --lang python --pattern basic
cd my-first-mcp


### 3. Run and Test```bash
# Python
pip install -e .
python -m my_first_mcp

# TypeScript
npm install
npm run dev

Architecture Patterns

Adapter Pattern

Transform external APIs into MCP-compatible tools.```python

Python Example

from mcpforge import MCPServer, tool, AdapterPattern

class GitHubAdapter(AdapterPattern):
"""Adapts GitHub API to MCP tools"""

def __init__(self, token: str):
    self.client = GitHub(token)

@tool(name="list_repos")
async def list_repositories(self, org: str) -> list[dict]:
    """List repositories for an organization"""
    return await self.client.repos.list(org=org)

server = MCPServer("github-mcp")
server.register_adapter(GitHubAdapter(token=os.getenv("GITHUB_TOKEN")))

// TypeScript Example
import { MCPServer, tool, AdapterPattern } from 'mcpforge';

class GitHubAdapter extends AdapterPattern {
  private client: Octokit;

  constructor(token: string) {
    super();
    this.client = new Octokit({ auth: token });
  }

  @tool({ name: 'list_repos' })
  async listRepositories(org: string): Promise<Repository[]> {
    const { data } = await this.client.repos.listForOrg({ org });
    return data;
  }
}
```

### Gateway Pattern

Centralized entry point for multiple MCP servers.```
                    +------------------+
                    |   MCP Gateway    |
                    |  (Auth, Routing) |
                    +--------+---------+
                             |
         +-------------------+-------------------+
         |                   |                   |
+--------v-------+  +--------v-------+  +--------v-------+
|  GitHub MCP    |  |  Database MCP  |  |  Storage MCP   |
|    Server      |  |    Server      |  |    Server      |
+----------------+  +----------------+  +----------------+
``````python
# Gateway Implementation
from mcpforge import Gateway, route, authenticate

gateway = Gateway("mcp-gateway")

@gateway.route("/github/*")
@authenticate(oauth2=True)
async def github_route(request):
    return await gateway.proxy("github-mcp", request)

@gateway.route("/database/*")
@authenticate(api_key=True)
async def database_route(request):
    return await gateway.proxy("database-mcp", request)
```

### More Patterns

See docs/patterns/ for complete documentation:

- Adapter Pattern - External API integration
- Facade Pattern - Simplified interfaces
- Proxy Pattern - Access control and caching
- Gateway Pattern - Centralized routing
- Circuit Breaker - Fault tolerance
- Bulkhead Pattern - Resource isolation
- CQRS Pattern - Command/Query separation
- Event Sourcing - State management

---

## Templates

### Python Templates

| Template | Use Case | Features |
|----------|----------|----------|
| `basic` | Simple MCP server | Single tool, stdio transport |
| `enterprise` | Production deployment | OAuth 2.1, logging, metrics |
| `microservices` | Distributed systems | Service discovery, tracing |

### TypeScript Templates

| Template | Use Case | Features |
|----------|----------|----------|
| `basic` | Quick prototypes | Minimal dependencies |
| `enterprise` | Full-stack apps | Express integration, SSE |
| `microservices` | Scalable systems | Docker, K8s manifests |

### Go Templates

| Template | Use Case | Features |
|----------|----------|----------|
| `basic` | CLI tools | Single binary output |
| `enterprise` | High-performance | Connection pooling, metrics |

### Rust Templates

| Template | Use Case | Features |
|----------|----------|----------|
| `basic` | Performance-critical | Async runtime, minimal alloc |
| `enterprise` | Systems integration | Tracing, custom transports |

---

## CLI Reference```bash
mcpforge <command> [options]

Commands:
  new <name>              Create a new MCP server project
  add <type> <name>       Add tool, resource, or prompt to existing project
  diagram <project>       Generate architecture diagram
  validate <project>      Validate project structure and code
  upgrade <project>       Upgrade to latest MCPForge patterns
  docs                    Open documentation in browser

Options:
  --lang, -l              Language: python, typescript, go, rust
  --pattern, -p           Pattern: basic, enterprise, microservices
  --transport, -t         Transport: stdio, sse, http
  --output, -o            Output format for diagrams: svg, png, mermaid
  --help, -h              Show help
  --version, -v           Show version
```

---

## Security Best Practices

MCPForge implements security patterns aligned with the MCP specification:

### Authentication```python
from mcpforge.security import OAuth2Provider, APIKeyAuth

# OAuth 2.1 (recommended for HTTP transport)
server.use_auth(OAuth2Provider(
    issuer="https://auth.example.com",
    audience="mcp-server"
))

# API Key (for internal services)
server.use_auth(APIKeyAuth(
    header="X-API-Key",
    validator=validate_key
))
```

### Rate Limiting```python
from mcpforge.security import RateLimiter

server.use_middleware(RateLimiter(
    requests_per_minute=60,
    burst=10
))
```

### Input Validation```python
from mcpforge.validation import Schema, validate

@tool(name="query_database")
@validate(Schema({
    "query": str,
    "limit": int & Range(1, 100)
}))
async def query_database(query: str, limit: int = 10):
    # Input is validated before execution
    pass
```

---

## Examples

### GitHub Integration Server```bash
mcpforge new github-mcp --lang python --pattern adapter
cd github-mcp
``````python
# src/github_mcp/server.py
from mcpforge import MCPServer, tool
from github import Github

server = MCPServer("github-mcp")

@server.tool()
async def search_code(query: str, repo: str) -> list[dict]:
    """Search code in a GitHub repository"""
    g = Github(os.getenv("GITHUB_TOKEN"))
    results = g.search_code(f"{query} repo:{repo}")
    return [{"path": r.path, "url": r.html_url} for r in results[:10]]

@server.tool()
async def create_issue(repo: str, title: str, body: str) -> dict:
    """Create a new issue in a repository"""
    g = Github(os.getenv("GITHUB_TOKEN"))
    repo = g.get_repo(repo)
    issue = repo.create_issue(title=title, body=body)
    return {"number": issue.number, "url": issue.html_url}

if __name__ == "__main__":
    server.run()
```

### Database Query Server```bash
mcpforge new database-mcp --lang typescript --pattern enterprise
cd database-mcp
``````typescript
// src/server.ts
import { MCPServer, tool } from 'mcpforge';
import { Pool } from 'pg';

const server = new MCPServer('database-mcp');
const pool = new Pool({ connectionString: process.env.DATABASE_URL });

server.tool({
  name: 'query',
  description: 'Execute a read-only SQL query',
  schema: {
    sql: { type: 'string', description: 'SQL query to execute' },
    params: { type: 'array', optional: true }
  }
}, async ({ sql, params }) => {
  // Only allow SELECT statements
  if (!sql.trim().toLowerCase().startsWith('select')) {
    throw new Error('Only SELECT queries are allowed');
  }
  const result = await pool.query(sql, params);
  return result.rows;
});

server.run();
```

---

## Architecture Diagrams

MCPForge auto-generates architecture diagrams from your code:```bash
mcpforge diagram my-server --output svg

+------------------------------------------------------------------+
| MCP Client |
| (Claude, ChatGPT, etc.) |
+----------------------------------+-------------------------------+
|
v
+------------------------------------------------------------------+
| MCP Gateway |
| [Auth] [Rate Limit] [Logging] [Routing] |
+--------+-------------------+-------------------+-----------------+
| | |
v v v
+----------------+ +----------------+ +----------------+
| GitHub MCP | | Database MCP | | Storage MCP |
| | | | | |
| Tools: | | Tools: | | Tools: |
| - search_code | | - query | | - upload |
| - create_issue | | - list_tables | | - download |
| - list_repos | | - describe | | - list_files |
+----------------+ +----------------+ +----------------+


---

## Roadmap

### v1.0 (Current)
- [x] Core design patterns library
- [x] Python templates (basic, enterprise)
- [x] TypeScript templates (basic, enterprise)
- [x] CLI scaffolding tool
- [x] Documentation site

### v1.1 (Planned)
- [ ] Go templates
- [ ] Rust templates
- [ ] Visual Studio Code extension
- [ ] Architecture diagram generator

### v2.0 (Future)
- [ ] MCP Gateway implementation
- [ ] Kubernetes operators
- [ ] Monitoring dashboard
- [ ] Plugin marketplace

---

## Contributing

We welcome contributions from the community. See CONTRIBUTING.md for guidelines.

### Development Setup```bash
git clone https://github.com/Richardmsbr/mcpforge.git
cd mcpforge
npm install
npm run build
npm link

Running Tests```bash

npm test # Unit tests
npm run test:integration # Integration tests
npm run test:e2e # End-to-end tests
```


Community

  • GitHub Discussions - Questions and ideas
  • Discord - Real-time chat
  • Twitter - Updates and announcements

License

MIT License - see LICENSE for details.


Acknowledgments

MCPForge builds upon the work of the MCP community:

  • Anthropic - Model Context Protocol specification
  • FastMCP - Python MCP framework
  • Official MCP SDKs - Reference implementations

Built with precision. Forged for production.


Author

Richard Sakaguchi - Solution Architect & AI Engineer

  • Website: sakaguchi.ia.br
  • SEO Tools: seoexpress.com.br
  • HuggingFace: yoshii-ai
  • LinkedIn: richard-ms

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Mcpforge Dfc08e46 怎么安装?

在客户端按下面的安装命令接入:pip install -e .。装完在客户端配置里引用同一个包或端点。

Mcpforge Dfc08e46 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Mcpforge Dfc08e46 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Mcpforge Dfc08e46 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Mcpforge Dfc08e46 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Mcpforge Dfc08e46 能提供哪些能力?

资料显示能力标签包括 命令行工具、TypeScript、Claude、生产就绪。具体工具清单以官方文档为准。

Mcpforge Dfc08e46 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Mcpforge Dfc08e46 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。