fa-mcp-sdk 0.2.104 → 0.2.106
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/cli-template/README.md +105 -0
- package/package.json +1 -1
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
# {{project.productName}}
|
|
2
|
+
|
|
3
|
+
{{project.description}}
|
|
4
|
+
|
|
5
|
+
## Install & Run
|
|
6
|
+
|
|
7
|
+
### Quick Start
|
|
8
|
+
```bash
|
|
9
|
+
# Install
|
|
10
|
+
npm install
|
|
11
|
+
|
|
12
|
+
# Configure (copy config/local.yaml from config/_local.yaml)
|
|
13
|
+
# Add database credentials
|
|
14
|
+
|
|
15
|
+
# Build
|
|
16
|
+
npm run build
|
|
17
|
+
|
|
18
|
+
# Run (STDIO mode for Claude Desktop)
|
|
19
|
+
npm start
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
### Test Run
|
|
23
|
+
```bash
|
|
24
|
+
# Unit tests
|
|
25
|
+
npm test
|
|
26
|
+
|
|
27
|
+
# MCP protocol tests
|
|
28
|
+
npm run test:mcp # STDIO mode
|
|
29
|
+
npm run test:mcp-http # HTTP mode
|
|
30
|
+
npm run test:mcp-simple # Simple test
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
### Dual Transport System
|
|
34
|
+
|
|
35
|
+
**STDIO Mode** (default for Claude Desktop):
|
|
36
|
+
- Direct stdin/stdout communication
|
|
37
|
+
- Optimal for Claude Desktop integration
|
|
38
|
+
- No network ports required
|
|
39
|
+
|
|
40
|
+
**HTTP Mode** (web integration):
|
|
41
|
+
- HTTP server with Server-Sent Events (SSE)
|
|
42
|
+
- About page with server status at `http://localhost:{{port}}/`
|
|
43
|
+
- Health check endpoint at `/health`
|
|
44
|
+
- Direct JSON-RPC 2.0 endpoint at `/mcp`
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
## Features
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
## MCP Tools
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
## MCP Prompts
|
|
56
|
+
|
|
57
|
+
### `agent_brief`
|
|
58
|
+
Brief description of agent capabilities for agent selection.
|
|
59
|
+
|
|
60
|
+
### `agent_prompt`
|
|
61
|
+
Complete prompt with instructions.
|
|
62
|
+
|
|
63
|
+
## MCP Resources
|
|
64
|
+
|
|
65
|
+
### `staff://agent/brief`
|
|
66
|
+
Same as `agent_brief` prompt. **MIME:** text/plain
|
|
67
|
+
|
|
68
|
+
### `staff://agent/prompt`
|
|
69
|
+
Same as `agent_prompt` prompt. **MIME:** text/plain
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
## 2. Configuration
|
|
73
|
+
|
|
74
|
+
**Option A: Configuration File**
|
|
75
|
+
|
|
76
|
+
**Option B: Environment Variables**
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
## Claude Desktop Setup
|
|
80
|
+
|
|
81
|
+
Add to `claude_desktop_config.json`:
|
|
82
|
+
|
|
83
|
+
```json
|
|
84
|
+
{
|
|
85
|
+
"mcpServers": {
|
|
86
|
+
"{{project.name}}": {
|
|
87
|
+
"command": "node",
|
|
88
|
+
"args": [
|
|
89
|
+
"<path-to-project>/mcp-staff-db/dist/src/index.js"
|
|
90
|
+
],
|
|
91
|
+
"env": {
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## HTTP Mode Endpoints
|
|
99
|
+
|
|
100
|
+
- **/** - About page
|
|
101
|
+
- **/health** - Health check
|
|
102
|
+
- **/sse** - Server-Sent Events
|
|
103
|
+
- **/mcp** - JSON-RPC 2.0
|
|
104
|
+
|
|
105
|
+
## Security
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fa-mcp-sdk",
|
|
3
3
|
"productName": "FA MCP SDK",
|
|
4
|
-
"version": "0.2.
|
|
4
|
+
"version": "0.2.106",
|
|
5
5
|
"description": "Core infrastructure and templates for building Model Context Protocol (MCP) servers with TypeScript",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"main": "dist/core/index.js",
|